MkDocsでサイト作り

1回目

  1. Githubでレポジトリを作る

  2. Cloud9で作る(Pythonを指定)

  3. 余分なファイルを消す

  4. Open Terminal Here

  5. mkdocsのインストール

    sudo pip install mkdocs
    
  6. フォルダを作成し、ディレクトリを変更

    mkdocs new フォルダ名    
    cd フォルダ名
    
  7. サイトをランする。  http://0.0.0.0:8080をクリックすることでサイトをブラウザで表示できる。

    mkdocs serve -a 0.0.0.0:8080
    
  8. いろいろ編集(編集方法は別ページで)

  9. htmlに変換

    mkdocs build
    
  10. GitHubにアップロード

    cd site    
    git init    
    git add .    
    git commit -m “コミットメッセージ”    
    git remote add origin https://github.com/名前/レポジトリ名.git    
    git push -u origin master    
    git branch gh-pages(ブランチを切る)    
    git checkout gh-pages(ブランチの移動)    
    git add .    
    git push -u origin gh-pages
    

    サイト名はhttps://ユーザーネーム.github.io/レポジトリの名前/

GitHubへのアップロードはmkdocs gh-deployのみで可能らしい(ためしてない)





2回目以降

  1. 編集する

  2. 新しくターミナルを開きディレクトリの変更

    cd フォルダ名
    
  3. htmlに変換

    mkdocs build
    
  4. GitHubにアップロード

    cd site    
    (git checkout gh-pages)既にgh-pagesなら不要    
    git add .    
    git commit -m “コミットメッセージ”    
    git push -u origin gh-pages