Minidown 项目使用教程

随笔2个月前发布 必癫狂
42 0 0

Minidown 项目使用教程

minidownMinidown is a lightweight & fast markdown parser, with complete GFM support.项目地址:https://gitcode.com/gh_mirrors/mi/minidown

1. 项目的目录结构及介绍

Minidown 项目的目录结构如下:

  1. minidown/

  2. ├── LICENSE

  3. ├── README.md

  4. ├── _config.yml

  5. ├── _data/

  6. │ └── members.yml

  7. ├── _drafts/

  8. │ ├── begin-with-the-crazy-ideas.md

  9. │ └── on-simplicity-in-technology.md

  10. ├── _includes/

  11. │ ├── footer.html

  12. │ └── header.html

  13. ├── _layouts/

  14. │ ├── default.html

  15. │ └── post.html

  16. ├── _posts/

  17. │ ├── 2007-10-29-why-every-programmer-should-play-nethack.md

  18. │ └── 2009-04-26-barcamp-boston-4-roundup.md

  19. ├── _sass/

  20. │ ├── _base.scss

  21. │ └── _layout.scss

  22. ├── _site/

  23. ├── .jekyll-cache/

  24. ├── .jekyll-metadata

  25. ├── about.md

  26. ├── assets/

  27. │ ├── css/

  28. │ └── images/

  29. └── index.md

目录介绍

  • LICENSE: 项目的许可证文件。
  • README.md: 项目的说明文档。
  • _config.yml: 项目的配置文件。
  • _data/: 存放项目的数据文件,如 members.yml
  • _drafts/: 存放未发布的草稿文章。
  • _includes/: 存放可重用的 HTML 片段,如页眉和页脚。
  • _layouts/: 存放页面布局模板。
  • _posts/: 存放已发布的文章。
  • _sass/: 存放 SASS 样式文件。
  • _site/: Jekyll 生成的静态站点文件。
  • .jekyll-cache/: Jekyll 的缓存文件夹。
  • .jekyll-metadata: Jekyll 的元数据文件。
  • about.md: 关于页面的 Markdown 文件。
  • assets/: 存放项目的静态资源,如 CSS 和图片。
  • index.md: 首页的 Markdown 文件。

2. 项目的启动文件介绍

Minidown 项目的启动文件是 index.md,它是项目的入口文件,负责展示首页内容。

index.md 内容示例

  1. ---

  2. layout: default

  3. title: 首页

  4. ---

  5. # 欢迎来到 Minidown

  6. 这是一个使用 Jekyll 构建的简单静态站点。

3. 项目的配置文件介绍

Minidown 项目的配置文件是 _config.yml,它包含了项目的全局配置信息。

_config.yml 内容示例

  1. title: Minidown

  2. email: your-email@example.com

  3. description: >- # this means to ignore newlines until "baseurl:"

  4. 这是一个使用 Jekyll 构建的简单静态站点。

  5. baseurl: "" # the subpath of your site, e.g. /blog

  6. url: "http://example.com" # the base hostname & protocol for your site, e.g. http://example.com

  7. twitter_username: jekyllrb

  8. github_username: jekyll

  9. # Build settings

  10. markdown: kramdown

  11. theme: minima

  12. plugins:

  13. - jekyll-feed

配置项介绍

  • title: 站点的标题。
  • email: 联系邮箱。
  • description: 站点的描述。
  • baseurl: 站点的子路径。
  • url: 站点的基本 URL。
  • twitter_username: Twitter 用户名。
  • github_username: GitHub 用户名。
  • markdown: 使用的 Markdown 解析器。
  • theme: 使用的主题。
  • plugins: 使用的插件列表。

以上是 Minidown 项目的基本使用教程,涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对你有所帮助!

minidownMinidown is a lightweight & fast markdown parser, with complete GFM support.项目地址:https://gitcode.com/gh_mirrors/mi/minidown

© 版权声明

相关文章

暂无评论

您必须登录才能参与评论!
立即登录
暂无评论...