GitHub Pages 应用jekyll模板的不显示图片

你好,

在你的md文件中  表示生成一个image标签,图片找不到那应该是地址问题,通过你的描述是托管在github上,那么github的.io域名是带有一个path的,

所以你的地址前应该也加上这个path,如yourname.github.io/blog/assets/img/fresh.gif.

手动加必定是繁琐的,所以可以在_config.yml中配置baseurl: blog,

页面中这样使用:


这样jekyll在生成网站是会自动加上这个path.

另外对于你的MarkDown疑惑:

Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

很庆幸jekyll采用了MarkDown形式文件作为基础.他的扩展名为.md/.markdown都会被jekyll识别渲染.使用markdown你可以更专注的关注内容而不用考虑样式.学习md仅仅需要几分钟.

如果你实在不想用md,完全可以在.md文件里写html.仍然会被渲染.

还有一个问题就是README.md 这个文件一般用于github对你仓库的描述文件,采用md语法在打开这个仓库时会自动渲染此文件.

如果还有其他问题欢迎追问,如果有所帮助敬请采纳.

github pages有两类：

你如果起个名为chendell.github.io的repository, 那么他的master分支上的文件就能在chendell.github.io的根目录访问到。

而如果是其他的repositories，比如这个repository名字叫node，那么建一个gh-pages分支，该分支下的文件就能在chendell.github.io/node/下访问到。

1. 门槛：需要理解 Github 的工作方式，熟悉 Github 客户端，熟悉 Html 与 CSS；

2. 不妨一边开始写静态模板，一边了解 Jekyll 布局所用到的 Liquid Tag，磨刀不误砍柴工；

3. Jekyll 博客，可以看作是一套文件结构，通过 Jekyll 程序编译成静态网站。如果不熟悉命令，完全可以不安装 Jekyll，只需按照要求的格式创建文件后再上传到 Github，然后访问主页就可以了，因为 Github Pages 便是由 Jekyll 驱动的，或者直接使用 Jekyll-Bootstrap 的结构；

4. Jekyll 的文件结构大概可以这样分：配置文件 _config.yml，布局文件 _layouts，模块文件 _includes，插件 _plugin，文章 _posts，其他文件（不以下划线开头的文件及文件夹都会完整的拷贝到生成的静态网站中，比如 CSS 文件、图片等），以及将会生成的静态站 _site；

5. Jekyll 命令很简单，先使用 cd 命令进入目标文件夹，然后输入 jekyll --server 生成网站，浏览器中输入 0.0.0.0:4000 访问生成的静态网站，jekyll --server --auto 命令将开启实时更新，修改文件后在浏览器中刷新就可看到效果，对本地调试很有帮助；

6. Github Pages 禁用所有插件，需要使用自定义插件，只能上传生成的网站文件 _site，或者试试 这个办法

7. 想写草稿不想被编译？创建一个以下划线开头文件夹就会被忽略，例如在 _posts 下创建 _drafts 存储草稿；

8. 默认的 Markdown 引擎问题很多，建议替换成 RDiscount。

首先，你要创建jekyll可以“存活”的ruby环境。为了达到这个目的，请先下载rubyinstaller（建议自行搜索下载。懒人请看图片一，我把官网地址也留在截图里面了）并且安装好。安装时请安装个路径名字短的，因为我们等会要手动输入到cmd命令栏里面。(例如，我直接安装在D盘，所以路径为D:\Ruby22-x64）

2

打开cmd命令窗（在电脑“开始”栏里面搜索“cmd”或者“命令提示符“），并且输入 cd /d D:\Ruby22-x64\bin

（斜体字部分是给完全技术小白阅读，如果已经掌握基本cmd命令的知识，请自行跳过斜体字部分！）这一步骤的目的是移到rubyinstaller安装目录下级的bin文件夹。这个命令会根据你安装路径不同而改变。比如，如果你安装在C盘根目录（C:\Ruby22-x64），那么这条命令应该修改为

cd Ruby22-x64\bin

在列一个例子，如果是安装在E:\Ruby22-x64，那么本命令则需要改为cd /e E

:\Ruby22-x64\bin

总结一下本命令要点：cd是移动路径的命令， /d表示要移到D盘，之后的路经地址则是你要进入的文件夹。

3

输入gem update -- system

本步骤是为了更新等下需要使用的rubygems系统，避免等会儿继续安装出错，所以还是先更新一下。你看到cmd命令栏里面显示RubyGems system software updated就说明可以下一步了。

4

在GitHub上面下载DevKit。请自行搜索下载，如果实在找不到，给个提示……请在本步骤图里面寻找……（有木有玩找茬的即视感？？）

rubyinstaller在github上面的下载包都在同一个页面，所以下载的时候看好了，我们需要的是DevKit

下载完成后自行解压DevKit，我解压至D:/DevKit，你们随意，和第一步一样，路径怎么短怎么来（注释：地址太长了也没问题，只不过等会儿手动输入的命令长而已），请记住你安装在哪里了，等会儿要用到安装途径。

好了，要用到刚才的安装途径了。回到cmd命令栏，输入cd D:\DevKit （和之前一样，如果安装途径不一样，自行调整cmd命令）

继续输入ruby dk .rb init

输入ruby dk .rb install

好了，至此jekyll需要的环境基本已经安装好了，可以开始安装jekyll了！在命令栏里面输入gem install jekyll

（提示，注意大小写，变成大写就会出问题）

检查一下是否安装成功。为了达到这个目的，输入查询jekyll版本号的命令

jekyll --version , 我cmd返回命令告诉我我已经安装了jekyll 3.0.1

好啦，现在可以新建一个本地博客啦！！！

输入jekyll new myblog

（输入该命令之后，你的DevKit文件夹里面就会生成一个叫myblog的文件夹。myblog可以随便换成你喜欢的名字，比如你想建一个新的博客叫Winter，那你就输入 kekyll new Winter ，以此类推）

进入myblog文件夹 cd myblog

（如果你的博客名为Winter，则输入cd Winter。注意大小写要和前一步输入的一致。）

输入jekyll serve

然后系统会告诉你本地网站已经搭建好了，在浏览器里面输入localhost:4000就能看到你刚刚建立好的最基本jekyll网站啦！

本教程至此结束！如果需要知道如何修改网页主题或者上传到你的空间商，请关注后续教程撒～～

---