分类分类
大小:6.58 MB 更新:2021/04/26
类别:编程工具系统:WinXP, Win7, Win8, Win10, WinAll
MkDocs提供静态网站生成功能,可以通过这款软件帮助用户快速生成个人网站,软件提供很多主题内容,您可以自定义网站主题,可以自定义HTML样式,大部分主题都是可以自己配置的,页面通过Markdown编辑,现在所有Markdown页面都包含在构建中,无论它们是否包含在导航配置中,导航现在可以包含到外部站点的链接,自动填充的导航现在将索引页面排在顶部,换句话说,索引页将被列为目录的第一个子级,而所有其他文档则按索引页后的文件名按字母数字顺序进行排序,提供一个新的url模板过滤器可以巧妙地确保所有URL都相对于当前页面,如果你需要建立静态的网站就可以下载MkDocs!
MkDocs是一种快速,简单和彻头彻尾的华丽是迈向建设项目文档面向静态网站生成器。文档源文件使用Markdown编写,并使用单个YAML配置文件进行配置。它的设计易于使用,并且可以通过第三方主题,插件和Markdown扩展进行扩展。
特征
从Markdown文件构建静态HTML文件。
使用插件和Markdown扩展来增强MkDocs。
使用内置主题,第三方主题或创建自己的主题。
将文档发布到可以提供静态文件的任何位置。
1、在任何地方托管
MkDocs构建完全静态的HTML网站,您可以将其托管在GitHub页面,Amazon S3或您选择的任何其他位置。
2、伟大的主题可用
MkDocs提供了许多漂亮的主题。在内置主题之间进行选择:mkdocs和readthedocs,选择MkDocs主题Wiki页面上列出的第三方主题之一,或构建自己的主题。
3、工作时预览您的网站
内置的dev-server允许您在编写文档时预览文档。每当您保存更改时,它甚至会自动重新加载并刷新浏览器。
4、易于定制
通过自定义主题和/或安装一些插件,使您的项目文档看起来像您想要的样子。
入门
入门非常容易。
mkdocs new my-project
cd my-project
花一点时间查看为您创建的初始项目。
有一个名为的配置文件mkdocs.yml,一个名为的文件夹 docs将包含您的文档源文件。现在,该docs 文件夹仅包含一个名为的文档页面index.md。
MkDocs带有内置的开发服务器,可让您在处理文档时对其进行预览。确保您与mkdocs.yml 配置文件位于同一目录中,然后通过运行以下mkdocs serve 命令来启动服务器:
http://127.0.0.1:8000/在浏览器中打开,您将看到默认的主页显示:
开发服务器还支持自动重装,并且只要配置文件,文档目录或主题目录中的任何内容发生更改,都将重建您的文档。
docs/index.md在您选择的文本编辑器中打开文档,将初始标题更改为MkLorum,然后保存您的更改。您的浏览器将自动重新加载,您应该立即看到更新的文档。
现在尝试编辑配置文件:mkdocs.yml。将site_name设置更改 为MkLorum并保存文件。
site_name: MkLorum
您的浏览器应立即重新加载,并且您会看到新的网站名称生效
添加页面
现在将第二页添加到您的文档中:
curl 'https://jaspervdj.be/lorem-markdownum/markdown.txt' > docs/about.md
由于我们的文档站点将包含一些导航标题,因此您可能需要编辑配置文件,并通过添加nav 设置在导航标题中添加有关每个页面的顺序,标题和嵌套的一些信息:
保存所做的更改,您现在将看到一个导航栏,其中带有Home和的About 项目位于左侧Search,而Previous,,以及Next项目位于右侧。
尝试菜单项,然后在页面之间来回导航。然后点击 Search。将出现一个搜索对话框,使您可以搜索任何页面上的任何文本。请注意,搜索结果包括网站上搜索词的所有出现,并直接链接到搜索词出现的页面部分。您可以毫不费力地完成所有工作!
主题化我们的文档
现在更改配置文件,以通过更改主题来更改文档的显示方式。编辑mkdocs.yml文件并添加theme设置:
保存所做的更改,您将看到正在使用ReadTheDocs主题。
更改图标图标
默认情况下,MkDocs使用MkDocs图标图标。要使用其他图标,请在中创建一个img子目录,docs_dir然后将自定义favicon.ico文件复制到该目录。MkDocs将自动检测该文件并将其用作您的收藏夹图标。
建立网站
很好看 您已经准备好部署MkLorum 文档的第一阶段。首先构建文档:
mkdocs build
这将创建一个名为的新目录site。看一下目录:
请注意,您的源文档已作为两个名为index.html和的HTML文件输出 about/index.html。您还可以将其他各种媒体site作为文档主题的一部分复制到目录中。您甚至还有一个sitemap.xml文件和mkdocs/search_index.json。
如果您正在使用源代码控制,例如,git您可能不想检查文档库在存储库中的构建。site/在.gitignore文件中添加一行 。
echo "site/" >> .gitignore
如果您使用的是其他源代码控制工具,则需要查看其有关如何忽略特定目录的文档。
一段时间后,文件可能会从文档中删除,但仍将保留在site目录中。要删除这些过时的文件,只需mkdocs 使用该--clean开关即可运行。
mkdocs build --clean
其他命令和选项
还有其他各种命令和选项。有关命令的完整列表,请使用--help标志:
mkdocs --help
要查看给定命令可用的选项列表,请将该--help标志与该命令一起使用。例如,要获取该build命令可用的所有选项的列表,请 运行以下命令:
mkdocs build --help
版本1.1.2(2020-05-14)
错误修正:规范化IP地址并将不支持的地址错误更改为警告(#2108)。
版本1.1.1(2020-05-12)
错误修正:通过支持SOURCE_DATE_EPOCH环境变量(#2100)允许确定压缩的站点地图 。
修正:使用README.md的index.html即使use_directory_urls是假的(#2081)。
错误修正:忽略以反斜杠(#1680)开头的链接。
错误修正:传递builder给on_serve事件,以便server.watch插件可以将其传递给该事件 (#1952)。
错误修正:lunr[languages]==0.5.8用于避免nltk不兼容(#2062)。
错误修正:确保转轮仅适用于Python 3(#2021)。
错误修正:清理dev_addr验证并禁止0.0.0.0(#2022)。
添加min_search_length对搜索插件参数的支持(#2014)。
错误修正:readthedocs主题code颜色(#2027)。
Embarcadero RAD Studio(多功能应用程序开发工具) 编程工具177.22 MB12
详情猿编程客户端 编程工具173.32 MB4.16.0
详情猿编程 编程工具173.32 MB4.16.0
详情VSCodium(VScode二进制版本) 编程工具76.23 MBv1.57.1
详情aardio(桌面软件快速开发) 编程工具9.72 MBv35.69.2
详情一鹤快手(AAuto Studio) 编程工具9.72 MBv35.69.2
详情ILSpy(.Net反编译) 编程工具3.97 MBv8.0.0.7339 绿色
详情文本编辑器 Notepad++ 编程工具7.81 MBv8.1.3 官方中文版
详情核桃编程 编程工具272.43 MBv2.1.120.0 官方版
详情delphi2007完整 编程工具1198 MB附安装教程
详情SAPIEN PrimalScript2015 编程工具78.02 MB附带安装教程
详情Alchemy Catalyst可视化汉化工具 编程工具81.00 MBv13.1.240
详情Professional Tag Editor(通用标签编辑器) 编程工具25.6 MBv1.0.6.8
详情Coffeecup HTML Editor(html网页编辑器) 编程工具68.98 MBv15.4 特别版
详情JCreator Pro 编程工具9.65 MBv5.0.1 汉化
详情WebStorm 12中文 编程工具209.88 MB附带安装教程
详情MSWLogo(多功能项目开发与管理工具) 编程工具2.25 MBv6.5 免费版
详情JetBrains datagrip 2018.2.1中文-datagrip 2018.2.1 编程工具160.88 MB附注册码汉化包
详情易安卓5.0 编程工具202 MBv5.0 附破解补丁
详情keil uvision5 编程工具271.63 MB附带安装教程
详情CIMCO Edit V8中文 编程工具248 MB附安装教程
详情IntelliJ IDEA 2020.1(java集成开发环境) 编程工具643.0 MB附安装教程
详情redis desktop manager2020.1中文 编程工具32.52 MB附带安装教程
详情猿编程 编程工具173.32 MB4.16.0
详情信捷PLC编程工具软件 编程工具14.4 MBv3.5.2 官方版
详情源码编辑器 编程工具201.0 MBv3.4.3 官方版
详情Microsoft Visual C++ 编程工具226.00 MBv6.0 SP6 简体中文版
详情s7 200 smart编程软件 编程工具187 MBv2.2 官方中文版
详情TouchWin编辑工具(信捷触摸屏编程软件) 编程工具55.69 MBv2.D2c 官方版
详情易语言5.8完美 编程工具312 MB5.8.1 破解增强版
详情Scraino(少儿编程软件) 编程工具272.93 MBv0.3.0 官方版
详情vs2008中文 编程工具1495 MB附序列号
详情e盾网络验证源码 编程工具25.77 MBV45 官方版
详情codeblocks 编程工具95.21 MBv13.12 中文完整版(带GNW编译器
详情Android Studio(安卓开发环境) 编程工具983.0 MBv3.5.0.21 汉化版(附安装教程)
详情源码编辑器pc版 编程工具201.0 MBv3.4.3 官方版
详情CH341A编程器 编程工具1.06 MB1.30 绿色中文版
详情layuiAdmin pro(layui后台管理模板系统) 编程工具0.57 MBv1.1.0 单页版
详情海龟编辑器 编程工具71.5 MBv0.8.4 中文版
详情Ardublock中文版(Arduino图形化编程软件) 编程工具2.65 MB附带安装教程
详情文本编辑器 Notepad++ 编程工具7.81 MBv8.1.3 官方中文版
详情富途牛牛 编程工具160.59 MBv11.8.9068 官方版
详情微信开发者工具 编程工具129.37 MBv1.05.2105170 官方版
详情UEStudio v18.0.0.18 简体中文绿色 编程工具19.00 MB
详情十六进制编辑器 WinHex 编程工具2.79 MBv20.2 SR-5
详情代码编辑器 Sublime Text 编程工具54.74 MBv4.0.0.4126
详情RJ TextEd(代码编辑器) 编程工具49.46 MBv15.31
详情核桃编程 编程工具272.43 MBv2.1.120.0 官方版
详情影刀 编程工具306.37 MBv4.9.14
详情Kate(高级文本编辑器) 编程工具56.11 MBv21.12.1.1544
详情