Mkdocsは、ブログを使って、簡単なドキュメントを作成します

I.概要

MkDocs迅速、簡単で、完璧な華やかな静的サイトジェネレータを作成するためのプロジェクトのドキュメントです。設定ファイルとしてYAMLファイルで、書くために値下げを使用してソースドキュメント。

あなたは、に行くことができるためにpythonの公式サイトダウンロードしてインストール、インストールオンライン方法は、繰り返しの多くを行うことはありません。

インストールがのpython3ピップを構築された後、すぐにmkdocsをインストールすることができます。

pip install mkdocs

ダウンロードが遅い場合は、クレソンなどのインストールソースを置き換えることができます

pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-material

ピップexeファイルをPythonで生成されるため利用できない場合は、環境変数を高めるために、cmdを使うことができます。

mkdocs new my-project

mkdocs.ymlレーンを追加しました：

theme:
  name: material

mkdocs gh-deploy
# 生成在site目录下，可以用浏览器查看效果

mkdocs serve
#通过浏览器打开 http://127.0.0.1:8000/ 查看效果

これを書いているので行っていない無サーバーの展開がないため、ここでは、国内giteeに配備されています。

登録、ログインコード雲、新倉庫

①右開きGitのBASH

②複製接続

③ドロップダウン倉庫

git clone 复制的连接

④mkdocsが生成されます私のプロジェクトは、倉庫のフォルダに移動プロジェクト
⑤アップロード

git add .
# 加入到暂存区

git commit -m up
# 提交到版本库

git push
# 上传