摘要:是一個對非常友好的文檔生成器,中文文檔地址使用我們可以用編寫自己的文檔,而且可以免費部署到。資源中文數據結構和算法教程類似生成文檔工具入坑指南配置文檔查詢工具支持數學公式配置多個公眾號蘇生不惑
mkdocs 是 Python 一個對 Markdown 非常友好的文檔生成器,中文文檔地址
使用 mkdocs 我們可以用md 編寫自己的文檔,而且可以免費部署到 GitHub 。
安裝pip install mkdocs
使用λ mkdocs.exe new mydoc INFO - Creating project directory: mydoc INFO - Writing config file: mydocmkdocs.yml INFO - Writing initial docs: mydocdocsindex.md λ cd mydoc d:codemydoc λ ls docs/ mkdocs.yml d:codemydoc λ mkdocs serve INFO - Building documentation... INFO - Cleaning site directory [I 190528 20:32:49 server:296] Serving on http://127.0.0.1:8000 [I 190528 20:32:49 handlers:62] Start watching changes [I 190528 20:32:49 handlers:64] Start detecting changes [I 190528 20:33:06 handlers:135] Browser Connected: http://127.0.0.1:8000/編輯
vi docs/index.md
把 command 改為中文 命令 記得把文件改為 utf8 編碼,否則
INFO - Building documentation... ERROR - Encoding error reading file: index.md ERROR - Error reading page "index.md": "utf-8" codec can"t decode byte 0xc3 in position 92: invalid continuation byte [E 190528 20:38:45 ioloop:801] Exception in callback>
刷新看到效果
vi mkdocs.yml
把site_name 的 my docs 改為中文 我的文檔
vi about.md
vi mkdocs.yml
site_name: 文檔 pages: - [index.md, Home] - [about.md, About]
然后報錯了
INFO - Building documentation... ERROR - Config value: "pages". Error: Invalid pages config. {} { , } [E 190529 09:57:45 ioloop:801] Exception in callback > Traceback (most recent call last): File "d:pythonlibsite-packages ornadoioloop.py", line 1229, in _run return self.callback() File "d:pythonlibsite-packageslivereloadhandlers.py", line 69, in poll_tasks filepath, delay = cls.watcher.examine() File "d:pythonlibsite-packageslivereloadwatcher.py", line 105, in examine func() File "d:pythonlibsite-packagesmkdocscommandsserve.py", line 107, in builder site_dir=site_dir File "d:pythonlibsite-packagesmkdocsconfigase.py", line 210, in load_config "Aborted with {0} Configuration Errors!".format(len(errors)) mkdocs.exceptions.ConfigurationError: Aborted with 1 Configuration Errors! λ mkdocs -V mkdocs, version 1.0.4 from d:pythonlibsite-packagesmkdocs (Python 3.7)
查找到issue https://github.com/mkdocs/mkd...
https://www.mkdocs.org/user-g...
改為
site_name: 我的文檔 nav: - 主頁: "index.md" - 關于: "about.md" theme: readthedocs
https://markdown-docs-zh.readthedocs.io/zh_CN/latest/
原來是中文文檔過時了。
生成秘鑰cd ~/.ssh
ssh-keygen -t rsa -C “mysusheng@gmail.com”
這里不要一路回車,我們自己手動填寫保存路徑
vi config
Host github.com HostName github.com User git IdentityFile ~/.ssh/mysusheng λ ssh -T git@github.com Hi sushengbuhuo! You"ve successfully authenticated, but GitHub does not provide shell access.站點生成
λ mkdocs build INFO - Cleaning site directory INFO - Building documentation to directory: d:codemydocsite d:codemydoc λ ls docs/ mkdocs.yml site/
一段時間后, 可能有文件被從源碼中移除了, 但是相關的文檔仍殘留在 site 目錄中. 在構建命令中添加 --clean 參數即可移除這些文檔.
$ mkdocs build --clean λ cd site d:codemydocsite λ ls 404.html css/ img/ js/ search.html sitemap.xml.gz about/ fonts/ index.html search/ sitemap.xml d:codemydocsite λ php -S localhost:8000 PHP 7.1.13 Development Server started at Wed May 29 10:17:19 2019 Listening on http://localhost:8000部署到GitHub
λ git clone https://github.com/sushengbuhuo/markdown_doc Cloning into "markdown_doc"... remote: Enumerating objects: 3, done. remote: Counting objects: 100% (3/3), done. remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 Unpacking objects: 100% (3/3), done. d:code λ cd markdown_doc d:codemarkdown_doc (master) λ ls README.md d:codemarkdown_doc (master) λ mkdir docs d:codemarkdown_doc (master) λ cd docs d:codemarkdown_docdocs (master) λ mkdocs.exe new . INFO - Writing config file: .mkdocs.yml INFO - Writing initial docs: .docsindex.md d:codemarkdown_docdocs (master) λ mkdocs build INFO - Cleaning site directory INFO - Building documentation to directory: d:codemarkdown_docdocssite d:codemarkdown_docdocs (master) λ echo "site/" >> .gitignore d:codemarkdown_docdocs (master) λ mkdocs gh-deploy --clean INFO - Cleaning site directory INFO - Building documentation to directory: d:codemarkdown_docdocssite WARNING - Version check skipped: No version specificed in previous deployment. INFO - Copying "d:codemarkdown_docdocssite" to "gh-pages" branch and pushing to GitHub. INFO - Your documentation should shortly be available at: https://sushengbuhuo.github.io/markdown_doc/
就是把site目錄代碼上傳到github gh-pages分支了.
瀏覽器訪問 https://sushengbuhuo.github.i... 看到效果了。
資源Python 中文數據結構和算法教程
類似gitbook生成文檔工具
Python Web 入坑指南
mkdocs配置
文檔查詢工具
支持數學公式
git配置多個SSH Key
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/43938.html
摘要:問題背景用戶可以運行但運行則下列錯誤經過排查,發現是在某些的權限問題解決方法查看使用的代碼可知,使用的是查看路徑切換到用戶然后在命令行運行路徑的權限修改路徑的權限發現有寫目錄是沒有執行權限的。 問題背景 root 用戶可以運行pip install mkdocs但gitlab-runner 運行pip install mkdocs 則下列錯誤 pip install mkdocs Tr...
摘要:蠎周刊年度最贊親俺們又來回顧又一個偉大的年份兒包去年最受歡迎的文章和項目如果你錯過了幾期就這一期不會丟失最好的嗯哼還為你和你的準備了一批紀念裇從這兒獲取任何時候如果想分享好物給大家在這兒提交喜歡我們收集的任何意見建議通過來吧原文 Title: 蠎周刊 2015 年度最贊Date: 2016-01-09 Tags: Weekly,Pycoder,Zh Slug: issue-198-to...
摘要:本文寫的是什么平時總要寫文檔。所以,我所希望的事,就是在完成代碼后,可以費很少的力氣,就生成一個像上文中所說的可調試文檔。我們接下來要做兩件事生成文檔文檔是可調試的文檔。一句話流程點擊生成按鈕,生成類的文檔。 本文寫的是什么? 平時總要寫文檔。不寫,代碼無法維護,所以不得不寫。但是寫文檔費時費力,更可怕的是寫完了讀起來還很費勁,束之高閣,總感覺時間浪費掉了,真是苦不堪言。 一直以來深受...
閱讀 940·2021-09-27 13:36
閱讀 888·2021-09-08 09:35
閱讀 1064·2021-08-12 13:25
閱讀 1437·2019-08-29 16:52
閱讀 2907·2019-08-29 15:12
閱讀 2726·2019-08-29 14:17
閱讀 2606·2019-08-26 13:57
閱讀 1012·2019-08-26 13:51