当前位置: 首页 > Web前端 > HTML

Windows环境下用Jekyll+Github搭建个人博客

时间:2023-04-02 11:52:35 HTML

萌新就来谈谈如何使用Jekyll搭建个人博客,从安装到配置!炸鸡的细节!.原文地址https://zhangmingemma.github....简介Jekyll是一个静态站点生成器,可以根据网页的源代码生成静态文件。简单的。无数据库,评论功能,无需不断更新版本,只关注自己博客的静态内容。仅使用Markdown(或Textile)、Liquid、HTML和CSS构建可部署的静态网站博客表单。自定义地址、分类页面、分类博客内容和自定义布局设计使用GitHubPages运行jekyll,在GitHub上发布网站环境配置、注册Github账号、创建新仓库非常简单且完全免费。教程第一部分,根据YoucandownloadandinstallGit,gitforWindows,安装教程安装Ruby&Devkit,Windows系统下,我们可以使用RubyInstaller安装Ruby环境,下载地址,安装教程配置jekyll环境(前提是你的电脑有Python,easy_install)安装jekyll$geminstalljekyll创建博客$jekyllnewmyBlog进入博客目录$cdmyBlog启动本地服务$jekyllserve在浏览器中输入:http://localhost:4000,即可看到你博客的效果。错误:自动重新生成:为“c:/Devkit/MyBlog”启用配置文件:c:/Devkit/MyBlog/_config.ymljekyll3.4.1|Error:Permissiondenied-bind(2)for127.0.0.1:4000*解决方法:先关闭后台开启的Apache和MySQL服务,重启jekyllserve,继续报错,然后在最后加上port:4001_config.yml文件的行。目录结构 Jekyll的核心其实是一个文本转换引擎。它的概念其实是:你用自己喜欢的标记语言写文章,可以是Markdown、Textile,也可以是简单的HTML,然后Jekyll会帮你插入一个或一系列布局。在整个过程中,您可以设置URL路径、文本在布局中的显示方式等。所有这些都可以通过纯文本编辑来实现,最终生成的静态页面就是您的成品。一个基本的Jekyll网站的目录结构通常是这样的:.├──_config.yml├──_includes|├──footer.html|└──header.html├──_layouts|├──default.html|├──post.html|└──page.html├──_posts|└──2016-10-08-welcome-to-jekyll.markdown├──_sass|├──_base.scss|├──_layout.scss|└──_syntax-highlighting.scss├──about.md├──css|└──main.scss├──feed.xml└──index.html这些目录结构和具体功能可以参考将官网文档进入_config.yml,修改成自己想看的信息,重启jekyllserver,刷新浏览器就可以看到刚才修改的信息了。至此,博客的初步搭建完成,将博客部署到远端,并在本地新建一个文件夹blog,在文件夹中打开gitbash,运行命令$gitclonehttps://github.com/(github用户名)/(github的仓库名).git可以看到文件夹(github的仓库名).git里面多了几个文件夹(包括隐藏的.git文件夹和READme文件)全部移动到blog目录下,并删除你在本地创建的博客文件(github仓库名)下的所有内容_config.yml、_layouts、_posts等。git文件夹,运行命令gitadd.gitcommit-a-m"firstcommit"gitremoteaddoriginhttps://github.com/(github用户名)/(github仓库名).gitgitpush-uoriginmaster如果它绑定了一个一级域名:首先在项目根目录下创建一个名为CNAME的文件,里面写上自己的和一级域名(比如本博客是skyinlayer.com),添加一个A在DNS中记录你的域名,指向207.97.227.245,将项目提交到github,稍等片刻(不超过1小时)baseurl你应该访问你自己的域名为“/”,看看结果。如果是绑定二级域名,需要在DNS中额外添加一个CNAME,指向(github用户名).github.io,然后在CNAME文件中修改为自己所有的文章都在_posts下目录,文章格式为mardown格式,文章文件名可以是.mardown或.md。写一篇新文章很简单,直接从_posts/目录下复制一份2016-10-16-welcome-to-jekyll.markdown,并改名为2016-10-16-article1.markdown,付费注意:文章名称的格式必须是前面的2016-10-16-,日期可以修改,但是必须是年-月-日-的格式,后面的article1是链接地址整篇文章。如果文章名称是中文,那么文章的链接URL会变成这样:http://baixin.io/2015/08/%E6%...,所以建议文章标题应该为英文或阿拉伯数字。双击2016-10-16-article1.markdown打开---layout:posttitle:"WelcometoJekyll!"date:2016-10-1611:29:08+0800categories:jekyllupdate---text...title:显示的文章名称,如:title:我的第一篇文章date:显示的文章发布日期,如:date:2016-10-16categories:tag标签的分类,如:categories:essayNote:文章标题的格式必须是上面的,....是文章的正文内容。我使用SublimeText3编辑器写文章,Markdown的简单语法使用博客模板。虽然博客部署完成了,但是你会发现博客太简单了,并不是你想要的。这里有很多漂亮的模板。选择自己喜欢的模板下载解压到目录,修改_config.yml和_posts为自己的资料和文章,使用命令部署本地服务$jekyllserver可能会出现一些错误:/Users/xxxxxxxx/.rvm/rubies/ruby-2.2.2/lib/ruby/site_ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in`require':cannotloadsuchfile--bundler(LoadError)from/Users/xxxxxxxx/.rvm/rubies/ruby-2.2.2/lib/ruby/site_ruby/2.2.0/rubygems/core_ext/kernel_require.rb:54:in`require'from/Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/gems/jekyll-3.3.0/lib/jekyll/plugin_manager.rb:34:in`require_from_bundler'来自/Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/gems/jekyll-3.3.0/exe/jekyll:9:in`'from/Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/jekyll:23:in`load'from/Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/jekyll:23:in`

'from/Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/ruby_executable_hooks:15:in`eval'from/Users/xxxxxxxx/.rvm/gems/ruby-2.2.2/bin/ruby_executable_hooks:15:in`
'原因:未安装bundler,在$gem中执行安装bundler命令stallbundler显示:Fetching:bundler-1.13.5.gem(100%)Successfullyinstalledbundler-1.13.5Parsingdocumentationforbundler-1.13.5Installingridocumentationforbundler-1.13.5Doneinstallingdocumentationforbundlerafter5seconds1geminstalled$jekyllserver,提供Couldnotfindproperversionofjekyll(3.1.1)inanyofthesources运行`bundleinstall`来安装缺少的gems。/................正在从https://rubygems.org/获取版本元数据..正在从https://rubygems.org/获取依赖项元数据。.安装jekyll-watch1.3.1安装jekyll3.1.1Bundle完成!3个Gemfile依赖项,现在安装了17个gem。使用`bundleshow[gemname]`查看捆绑的gem的安装位置。Bundler安装完毕,然后再次启动本地服务$jekyll服务器继续报错配置文件:/Users/tendcloud-Caroline/Desktop/XXXXXXXXXXXX/_config.ymlDependencyError:Yikes!看起来您没有安装jekyll-sitemap或其依赖项之一。为了按照当前配置使用Jekyll,您需要安装这个gem。来自Ruby的完整错误消息是:“无法加载此类文件--jekyll-sitemap”如果您遇到麻烦,可以在http://jekyllrb.com/help/找到有用的资源!杰基尔3.1.1|报错:jekyll-sitemap提示没有安装gemjekyll-sitemap配置文件:/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/XXXXXXXXXXXXX/_config.yml来源:/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/XXXXXXXXXXXX目的地:/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/XXXXXXXXXXXXXX/_site增量构建:禁用。启用--incrementalGenerating...在0.901秒内完成。自动重新生成:启用'/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/XXXXXXXXXXXXX'配置文件:/Users/baixinpan/Desktop/OpenSource/Mine/Page-Blog/XXXXXXXXXXXXX/_config.yml服务器地址:http://127.0.0.1:4000/服务器正在运行...按ctrl-c停止。表示本地服务部署成功。在浏览器中输入127.0.0.1:4000,即可看到博客效果。