MkDocs Material 安装部署和使用
MkDocs 是一个快速、简单、华丽的静态网站生成器,适用于构建项目文档。文档源文件以 Markdown 编写,并使用一个 YAML 文件来进行配置。Material for MkDocs 是 MkDocs 的一个主题配置,更加简洁美观,更新和维护也更加及时和频繁,且社区也更加活跃。
MkDocs 是一个快速、简单、华丽的静态网站生成器,适用于构建项目文档。文档源文件以 Markdown 编写,并使用一个 YAML 文件来进行配置。Material for MkDocs 是 MkDocs 的一个主题配置,更加简洁美观,更新和维护也更加及时和频繁,且社区也更加活跃。
Material for MkDocs 从 9.2.0 开始内置博客插件,内置博客插件添加了对从帖子文件夹构建博客的支持,这些帖子带有日期和其他结构化数据注释。
这个方法最开始是在 Linlin Yan (颜林林) 的 GitHub Pages 上第一次看到。后来,随着自己也用上了,就开始有了更深一些的认识。
关于写作原本的想法,只是想写点自己在学习、工作、生活上的一些心得和体会,把一些知识点记录下来。
留言的初衷是,希望自己写下来的东西能够有人一起探讨。哪怕你把我的观点批评得一无是处也可以,哪怕你说我的句子狗屁不通也没关系,只要有评判,我相信总有一天我会变得更好。
作者 | Niko McCarty
翻译 | 章鱼猫先生
日期 | 原文发表于 2022.12.10
来源 | Biology Breakthroughs of 2022 - Codon您正在阅读 Codon,这是一份关于生物 + 技术进步和为人类创造更光明未来的想法的时事通讯。
这是今年的最后一部作品。几周后我会在这里见到你!
大家可能会发现自从 2023 年下半年以来,“BioIT 爱好者” 公众号的更新频率越来越低了。
这里面除了个人私人时间越来越少以外,还有一个原因就是个人把写文章从语雀转移到了 GitHub 的 Issues 和 Discussions 上。
在语雀写文档写得多的,会对原始的 Markdown 越来越不敏感。
语雀的富文本编辑器虽然支持的依然是 markdown,但也有它自身的一些与传统 markdown 不一样的写法,例如 高亮块。这样的编辑器把 markdown 的源码给隐藏了——在用户编辑的时候实时进行渲染,这样对于不熟悉 markdown 的用户也极容易上手。
看到 HelloGitHub 公众号在 2019-09-25 发表的这篇文章《和微信公众号编辑器战斗的日子》,结合自己最近折腾的 React 版本应用 Markdown2Html,也想着来聊几句。
作者:Natalie Whitaker
编译:沈维燕
时间:2023-08-14
原文:2023 Galaxy Community Conference Meeting Report