前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >开发工具总结(14)之Jekyll制作文档并发布到GitHub

开发工具总结(14)之Jekyll制作文档并发布到GitHub

作者头像
AWeiLoveAndroid
发布2019-07-08 16:12:34
1K0
发布2019-07-08 16:12:34
举报
文章被收录于专栏:Flutter入门到实战

版权声明:本文为博主原创文章,未经博主允许不得转载。https://cloud.tencent.com/developer/article/1459089

转载请标明出处:

https://cloud.tencent.com/developer/article/1459089

本文出自 AWeiLoveAndroid的博客


在线文档制作工具系列篇 ↓:

Jekyll做博客有点复杂,如果说小白,不推荐轻易上手,出现的问题也是很多的,这里仅作为学习和交流。如果你对前端技术很感兴趣,或者你有前端开发经验,那么你开源随意定制化Jekyll模板,相对来说处理出现的错误问题也会比一般人及时一些。由于我对这个还不是很熟悉,希望各位大佬指教。这里出现的错误,欢迎大家指点。本文简单讲接一下Jekyll如何制作文档。


一、制作个人博客步骤

第一步:打开Jekyll主题官网 JekyllThemes http://jekyllthemes.org/ 下载一个自己喜欢的模板。
第二步:把下载好的模板上传到自己的Github仓库中。
第三步:在_posts文件夹中放入自己写好的博客,文件名必须是日期-标题名,例如:2019-01-01-我的第一篇博客
第四步:上传博客到Github中即可访问自己的博客。

二、Jekyll目录和文件结构介绍

文件 / 目录

描述

_config.yml

保存配置数据。很多配置选项都会直接从命令行中进行设置,但是如果你把那些配置写在这儿,你就不用非要去记住那些命令了。

_drafts

drafts 是未发布的文章。这些文件的格式中都没有 title.MARKUP 数据。学习如何使用 drafts.

_includes

你可以加载这些包含部分到你的布局或者文章中以方便重用。可以用这个标签 {% include file.ext %} 来把文件 _includes/file.ext 包含进来。

_layouts

layouts 是包裹在文章外部的模板。布局可以在 YAML 头信息中根据不同文章进行选择。 这将在下一个部分进行介绍。标签 {{ content }} 可以将content插入页面中。

_posts

这里放的就是你的文章了。文件格式很重要,必须要符合: YEAR-MONTH-DAY-title.MARKUP。 The permalinks 可以在文章中自己定制,但是数据和标记语言都是根据文件名来确定的。

_data

放一些其他配置文件,必须是.yml或者.yaml格式的,比如有一个文件叫members.yml,如果想引用这个文件里的内容就通过site.data.membres来引用

_site

一旦 Jekyll 完成转换,就会将生成的页面放在这里(默认)。最好将这个目录放进你的 .gitignore 文件中。


三、相关语法官网


四、比较好的Jekyll模板

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2019.07.05 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、制作个人博客步骤
    • 第一步:打开Jekyll主题官网 JekyllThemes http://jekyllthemes.org/ 下载一个自己喜欢的模板。
      • 第二步:把下载好的模板上传到自己的Github仓库中。
        • 第三步:在_posts文件夹中放入自己写好的博客,文件名必须是日期-标题名,例如:2019-01-01-我的第一篇博客。
          • 第四步:上传博客到Github中即可访问自己的博客。
          • 二、Jekyll目录和文件结构介绍
          • 三、相关语法官网
          • 四、比较好的Jekyll模板
          相关产品与服务
          网站建设
          网站建设(Website Design Service,WDS),是帮助您快速搭建企业网站的服务。通过自助模板建站工具及专业设计服务,无需了解代码技术,即可自由拖拽模块,可视化完成网站管理。全功能管理后台操作方便,一次更新,数据多端同步,省时省心。使用网站建设服务,您无需维持技术和设计师团队,即可快速实现网站上线,达到企业数字化转型的目的。
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档