The documentation website is built using MkDocs. This requires you to install python to deploy the website. MkDocs supports Python versions 2.7, 3.4, 3.5, 3.6, 3.7.
The main configuration of the website happens through the mkdocs.yml file. This defines various things like extra css, favicons, icons as well as the main navigation of the website.
All of the main pages exist in docs directory. To add a new page, simply add a new markdown file to the docs directory. Once that's done, simply add the title of the page and the name of the file in the nav
section of mkdocs.yml like so:
nav:
- 'New Page': new_page.md
- 'Nested Page': nested_page.md
-- 'Top Level Page': top_level_page.md
You can find the markdown file corresponding to the page that you want to edit by checking the mkdocs.yml
file and finding the nav
section. This should have the markdown file name.
You can then find that file in the docs
directory. After you've made changes to that file, get them merged in and deploy the website
You can add your own CSS in the app.css file.
The website can be deployed by executing the deploy_website.sh
script like so:
./deploy_website.sh
The script does the following:
README.md
, CHANGELOG.md
, CONTRIBUTING.md
etc into the docs
folder. This is done because these markdown files are required to be in the GitHub repo and we copy it over so that we don't create duplicates.此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。