您所在的位置:下载吧 > 软件下载 > 网络软件 > 网页制作 > MkDocs(静态网站生成器)下载

MkDocs(静态网站生成器) v1.1.2 免费版

  • 软件大小:6.59 MB
  • 软件语言:英文
  • 更新时间:2021-05-04
  • 授   权:免费软件
  • 适用平台:WinAll
  • 推荐度: 6
  • 开发商:未知
无病毒官方版
点击查看大图
软件介绍

  MkDocs是一款静态网页生成工具,使用这款工具可以让用户轻松创建静态网页并进行发布;该工具并不是一个独立的应用程序,用户在使用这款工具之前需要将其进行部署才可以使用;这款工具支持多种部署方式,无论通过哪一种方式进行部署都是非常便捷的;MkDocs是基于Markdown的网页生成工具,因此您可以通过扩展Markdown插件来让这款工具的功能变得更加强大;关于软件的外观,它自带了几种不同风格的主题,你可以按个人喜好选择使用,或者也可以自行创建主题,非常的灵活;需要的朋友欢迎下载。

MkDocs(静态网站生成器)

软件功能

  在任何地方托管

  MkDocs构建完全静态的HTML网站,您可以将其托管在GitHub页面,Amazon S3或您选择的任何其他位置。

  伟大的主题可用

  MkDocs提供了许多漂亮的主题。在内置主题之间进行选择:mkdocs和readthedocs,选择MkDocs主题Wiki页面上列出的第三方主题之一,或构建自己的主题。

  工作时预览您的网站

  内置的dev-server允许您在编写文档时预览文档。每当您保存更改时,它甚至会自动重新加载并刷新浏览器。

  易于定制

  通过自定义主题和/或安装一些插件,使您的项目文档看起来像您想要的样子。

软件特色

  1、简单易部署,适合拥有各种经验的用户使用,包括初学者也能轻松使用。

  2、通过这款工具可以让用户从Markdown文件上轻松创建静态的html文件。

  3、如果用户需要更多的功能可以使用插件和Markdown扩展来增强MkDocs。

  4、这款工具自带多种特色主题和第三方主题,您也可以自行创建主题。

  5、在这款工具中,您可以在任何支持静态文件的地方发布您创建的HTML文档。

  6、如果您需要创建静态网页的话,那么欢迎您下载这款网页生成工具使用。

官方教程

  安装

  使用程序包管理器安装

  如果您拥有并使用软件包管理器(例如apt-get,dnf,homebrew, yum,Chocolatey等)在系统上安装软件包,则可能需要搜索“ MkDocs”软件包,如果是最新版本,可以使用该版本,请与软件包管理器一起安装(有关详细信息,请参阅系统的文档)。就是这样,您完成了!跳至入门。

  如果您的程序包管理器没有最新的“ MkDocs”程序包,则仍可以使用程序包管理器来安装“ Python”和“ pip”。然后,您可以使用pip 安装MkDocs。

  手动安装

  为了手动安装MkDocs,您需要在系统上安装Python,以及Python包管理器pip。您可以从命令行检查是否已经安装了这些工具:

  $ python --version

  Python 3.8.2

  $ pip --version

  pip 20.0.2 from /usr/local/lib/python3.8/site-packages/pip (python 3.8)

  MkDocs支持Python版本3.5、3.6、3.7、3.8和pypy3。

  安装Python

  通过从python.org下载适合您系统的安装程序 并运行它来安装Python。

  笔记

  如果要在Windows上安装Python,请确保选中该复选框以将Python添加到您的PATH(如果安装程序提供了这样的选项)(默认情况下通常处于关闭状态)。

MkDocs(静态网站生成器)

  安装点

  如果您使用的是最新版本的Python,则默认情况下很可能会安装Python软件包管理器pip。但是,您可能需要将pip升级到最新版本:

  pip install --upgrade pip

  如果您是第一次安装pip,请下载get-pip.py。然后运行以下命令进行安装:

  python get-pip.py

  安装MkDocs

  mkdocs使用pip安装软件包:

  pip install mkdocs

  现在,您应该mkdocs在系统上安装了该命令。跑去mkdocs --version检查一切正常。

  $ mkdocs --version

  mkdocs, version 0.15.3

  笔记

  如果您希望为MkDocs安装手册页,则点击即用工具可以为您生成并安装它们,只需运行以下两个命令:

  pip install click-man

  click-man --target path/to/man/pages mkdocs

  请参阅点击手册文档,以获取有关为什么pip无法自动生成和安装手册页的说明。

  笔记

  如果您使用的是Windows,则上述某些命令可能无法立即使用。

  一个快速的解决方案可能是在每个Python命令前添加python -m 这样的命令:

  python -m pip install mkdocs

  python -m mkdocs

  对于更永久的解决方案,您可能需要编辑PATH环境变量以包含ScriptsPython安装目录。最新版本的Python包含一个脚本来为您执行此操作。导航至您的Python安装目录(例如C:\Python38\),打开Tools,然后打开 Scripts文件夹,然后win_add2path.py双击该文件来运行该文件。或者,您可以下载脚本并运行它(python win_add2path.py)。

  入门

  入门非常容易。

  mkdocs new my-project

  cd my-project

  花一点时间查看为您创建的初始项目。

MkDocs(静态网站生成器)

  有一个名为的配置文件mkdocs.yml,一个名为的文件夹 docs将包含您的文档源文件。现在,该docs 文件夹仅包含一个名为的文档页面index.md。

  MkDocs带有内置的开发服务器,可让您在处理文档时对其进行预览。确保您与mkdocs.yml 配置文件位于同一目录中,然后通过运行以下mkdocs serve 命令来启动服务器:

  $ mkdocs serve

  INFO - Building documentation...

  INFO - Cleaning site directory

  [I 160402 15:50:43 server:271] Serving on http://127.0.0.1:8000

  [I 160402 15:50:43 handlers:58] Start watching changes

  [I 160402 15:50:43 handlers:60] Start detecting changes

  http://127.0.0.1:8000/在浏览器中打开,您将看到默认的主页显示:

MkDocs(静态网站生成器)

  开发服务器还支持自动重装,并且只要配置文件,文档目录或主题目录中的任何内容发生更改,都将重建您的文档。

  docs/index.md在您选择的文本编辑器中打开文档,将初始标题更改为MkLorum,然后保存您的更改。您的浏览器将自动重新加载,您应该立即看到更新的文档。

  现在尝试编辑配置文件:mkdocs.yml。将site_name设置更改 为MkLorum并保存文件。

  site_name: MkLorum

  您的浏览器应立即重新加载,并且您会看到新的网站名称生效。

MkDocs(静态网站生成器)

  添加页面

  现在将第二页添加到您的文档中:

  curl 'https://jaspervdj.be/lorem-markdownum/markdown.txt' > docs/about.md

  由于我们的文档站点将包含一些导航标题,因此您可能需要编辑配置文件,并通过添加nav 设置在导航标题中添加有关每个页面的顺序,标题和嵌套的一些信息:

  site_name: MkLorum

  nav:

  - Home: index.md

  - About: about.md

  保存所做的更改,您现在将看到一个导航栏,其中带有Home和的About 项目位于左侧Search,而Previous,,以及Next项目位于右侧。

MkDocs(静态网站生成器)

  尝试菜单项,然后在页面之间来回导航。然后点击 Search。将出现一个搜索对话框,使您可以搜索任何页面上的任何文本。请注意,搜索结果包括网站上搜索词的所有出现,并直接链接到搜索词出现的页面部分。您可以毫不费力地完成所有工作!

MkDocs(静态网站生成器)

  主题化我们的文档

  现在更改配置文件,以通过更改主题来更改文档的显示方式。编辑mkdocs.yml文件并添加theme设置:

  site_name: MkLorum

  nav:

  - Home: index.md

  - About: about.md

  theme: readthedocs

  保存所做的更改,您将看到正在使用ReadTheDocs主题。

MkDocs(静态网站生成器)

  更改图标图标

  默认情况下,MkDocs使用MkDocs图标图标。要使用其他图标,请在中创建一个img子目录,docs_dir然后将自定义favicon.ico文件复制到该目录。MkDocs将自动检测该文件并将其用作您的收藏夹图标。

  建立网站

  很好看 您已经准备好部署MkLorum 文档的第一阶段。首先构建文档:

  mkdocs build

  这将创建一个名为的新目录site。看一下目录:

  $ ls site

  about fonts index.html license search.html

  css img js mkdocs sitemap.xml

  请注意,您的源文档已作为两个名为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

  部署中

  您刚刚构建的文档站点仅使用静态文件,因此您几乎可以从任何地方托管它。GitHub项目页面和Amazon S3可能是不错的托管选项,具体取决于您的需求。将整个site目录的内容上传到托管网站的任何位置。

MkDocs(静态网站生成器)下载地址

你可能感兴趣的软件
  • Amazing Slider 6.6 官方版

    28.16 MB/2017-09-19

    Amazing Slider 是一个易于使用的 Windows 和 Mac 应用程序。它可以快速的创造漂亮而又专业的,反应灵敏轮播滑块,视频库和 WordPress的滑块插件等。软件采用可视化操作,非常的简洁,使用非常简单。菜鸟也可以做出专业的动

  • Actual Drawing 7.4 官方版

    6.29 MB/2016-04-21

    Actual Drawing是功能强大的网页制作软件,让你不需要再撰写繁杂的HTML程序码,只要通过几个轻松简单的步骤便可完成网页设定。另外它强大的影像编辑功能让你在编修网页图形时

  • Intellyweb 1.1.0.3 官方版

    17.09 MB/2016-04-20

    Intellyweb是一个网页制作工具, 通过它可以使任何人非常简单的制作出功能丰富且美观的网站。软件基于一个方便用户的专业设计模板, 可以很容易的填写本文,图像和链接。 简单的点

  • 疯狂网页批量加密器 1.0.0 官方版

    5.5 MB/2016-04-19

    是一个静态网页的加密工具。所谓静态,指的是通常意义上扩展名为.htm或.html的网页文件,并不适用于服务器端运行的扩展名为.asp和.jsp之类的文件。它具有加、解密速度快、不增

  • Xbar-R Discern 1.01 官方版

    695 KB/2016-04-11

    Xbar-R Discen 1.0--本@Soft工作室的第一个软件。 是SPC软件系统的其中一个模块,专门制作“平均值 - 极值控制图, 帮助企业稳定生产过程和评估过程能力。通过

  • Apycom Java Menus and Buttons 5.0 官方版

    2.09 MB/2016-04-11

    轻松创建网站导航菜单、按钮的可视化网页制作工具,能制作下拉菜单、XP风格菜单、Flash菜单按钮、动画按钮、XP风格网页按钮、Ani

  • 易优网页加密压缩器 1.1 官方版

    161 KB/2016-04-06

      一款网页制作辅助工具,可以对网页的html文件压缩,压缩率高到可达%50,这样可以使您网页的浏览者用最少的时间观赏到您的网页,而无须那段漫长的等待。同时它也可对网页进行加密,可

  • EasyPad WAPtor 2.3 官方版

    706 KB/2016-04-05

    EasyPad WAPtor是一款简单易用的,特别适合刚开始学习编写wap网页的人使用。建立wap站点比起web站点来要简单的多,虽然wap是一项新的技术,但这并不意味着你得花掉更

  • GlobalSCAPE CuteSITE Builder 4.0 Build 108 官方版

    6.78 MB/2016-03-31

    CuteSITE Builder 是一个WYSIWYG的网页制作工具,可以方便地插入文字、图片摆置、对话框加入或多媒体文件加入均得心应手。内置模版供您参考,可以时发布到网络上。Cu

  • Platypus Web Builder 2.2 官方版

    8.62 MB/2016-03-31

    Platypus Web Builder可以帮助您可视化的建立交互式网站。 开发完全互动的网站,而无需编程或设计的丰富知识的理想工具。 此应用程序可帮助您创建一个网页与移

  • 沐风网页三叉戟 3.75 官方版

    324 KB/2016-03-31

      是一款功能强大的网页制作辅助工具。软件由三个部分组成:沐风特效工具、沐风取色工具和沐风剪贴板。沐风特效工具现收集各种特效100来个,虽然不是最多的,但是每一个特效都是经过作者精

  • ASPRunner.NET 5.0.4837 官方版

    7.37 MB/2016-03-28

    ASPRunner.NET是一款ASP网页制作工具,可以生成读写Oracle, SQL Server, MS Access, DB2, MySQL, FileM

您可能感兴趣的相关教程
每日更新软件推荐
  • 一周最热
  • 总排行榜

您可能感兴趣的专题

  • 男生必备

    男生必备

    男生们看过来!

  • 安卓装机必备

    安卓装机必备

  • 女生必备

    女生必备

      女生必备app是拥有众多女性用户的手机软件,作为一个女生,生活中像淘宝、京东这类线上购物软件可以说是少不了的,小红书这种穿搭、化妆分享平台也很受欢迎,类似于西柚大姨妈、美柚这种专为女生打造的生理期app更是手机必备,还有大家用的最多拍照美颜app是绝对不能忘记的,除此之外对于一些追星女孩来说,微博也是一个必不可少的软件。超多女生必备软件尽在下载吧!

  • 迅雷看看使用教程

    迅雷看看使用教程

    迅雷看看播放器是一款多功能在线高清多媒体视频播放器,支持本地播放与在线视频点播,采用P2P点对点传输技术,可以在线流畅观看高清晰电影。不仅如此,迅雷看看不断完善用户交互和在线产品体验,让您的工作与生活充满乐趣。

  • 驱动精灵

    驱动精灵

    驱动精灵是一款集驱动管理和硬件检测于一体的、专业级的驱动管理和维护工具。驱动精灵为用户提供驱动备份、恢复、安装、删除、在线更新等实用功能,也是大家日常生活中经常用到的实用型软件之一了。

  • 拼音输入法

    拼音输入法

    对于电脑文字输入,拼音输入法是一种非常受欢迎的输入法,搜狗拼音输入法、百度拼音输入法、QQ拼音输入法、谷歌拼音输入法、紫光拼音输入法、智能拼音输入法等,你在用哪款呢?一款好用适合自己的拼音输入法一定对您平时帮助很大!下载吧收集了最热门国人最喜欢用的拼音输入法给大家。

  • b站哔哩哔哩怎么使用

    b站哔哩哔哩怎么使用

    很多人都喜欢在b站哔哩哔哩上观看视频,不单是因为可以提前看到一些视频资源,B站的一些弹幕、评论的玩法也是被网友们玩坏了!下面下载吧小编带来了b站哔哩哔哩怎么使用的教程合集!希望能帮到你啦!

  • 抖音短视频app

    抖音短视频app

    抖音短视频app,这里汇聚全球潮流音乐,搭配舞蹈、表演等内容形式,还有超多原创特效、滤镜、场景切换帮你一秒变大片,为你打造刷爆朋友圈的魔性短视频。脑洞有多大,舞台就有多大!好玩的人都在这儿!