pelicanでブログを書きgithub-pageに公開

2615 ワード

プログラマーとしてブログのメモを書くのは一般的で役に立つことですが、mdでドキュメントを書くのに慣れています.以下、mdでブログを書くツールを紹介します.
機能の特徴
  • マルチトピック選択、カスタムトピック
  • md
  • を保持する
  • 純静的
  • 市場には実はhexo Jekyllがあり、同じ機能を持っています.どうしてpelicanを選んだの?pelicamはpythonに基づいているからです.他のhexoはnodejsに基づいて、Jekyllはrubyのようです.
    インストールの使用
    インストール
     pip install pelican markdown
     sudo -H pip install pelican markdown ##mac   
    

    プロジェクトの作成
    mkdir -p ~/projects/yoursite  ##        
    cd ~/projects/yoursite
    
    pelican-quickstart  ##            
    

    文章を1編書く.
    cd content
    code hello-world.md  ##  vs-code  md        cmd  vscode
    

    次の内容を書き込みます.
    Title: hello world
    Date: 2010-12-03 10:20
    Category: Review
    
    hello,world
    

    静的ファイルの生成
    pelican content
    

    プレビュー
    cd output
    python -m pelican.server
    

    ブラウザで表示http://localhost:8000/
    テーマのインストール
    からhttps://github.com/getpelican/pelican-themes好きなテーマを選んで
    pelican-themes -l #        
    pelican-themes --install ~/Dev/Python/pelican-themes/notmyidea-cms --verbos ##        
    pelican-themes --remove two-column ##    
    pelican-themes --symlink ~/Dev/Python/pelican-themes/two-column ##symlink            
    

    私はforkの公式の1つのテーマをしてそして住所を修正します以下の通りです[email protected]:visonforcoding/attila.git
    コンフィギュレーション
    THEME = "attila"
    
    COLOR_SCHEME_CSS = 'monokai.css'  ##        
    
    DISQUS_SITENAME = "your-domain"  ##disqus   
    

    github pageにパブリッシュ
    まずgithub page repositoryが必要です.具体的には公式ドキュメントを参照してください.https://pages.github.com/非常に詳しく書いてある
    ここでは主に生産のoutputをあなたのgithub repositoryに発表する方法を紹介します.実は公式にghp-importを提供していますが、自分が望んでいるのとは違うと思います.そのため、自分のやり方で来ます.原理はfabricを利用してoutput pushをgithubに送ることである.fabfile.を修正するpy私の構成は次のとおりです.
    def gh_pages():
        """Publish to GitHub Pages"""
        # rebuild()
        # local("ghp-import -b {github_pages_branch} {deploy_path} -p".format(**env))
        local("pelican content")
        local("cd content && git add . && git commit -m 'update md' && git push origin master && cd ../")
        local("cd output && git add . && git commit -m 'update blog' && git push origin master && cd ../")
    

    gh_の変更pagesメソッドは、contentのmdをgithub保存に提出したいためgit commitとpushが2つあります.変更後fabコマンドを実行すると、content pushからmd repository、content pushからpage repositoryになります.
    fab gh_pages
    

    訪問するgithub.io私の住所https://visonforcoding.github.io/
    image.png