Blended

ブレンド

Blended は、Python で書かれた静的 Web サイト ジェネレーターであり、GPL 3.0 オープンソース ライセンスに基づいてライセンスされています。 HTML ベースのテンプレート システム、HTML で記述されたコンテンツ、Markdown、Textile、reStructuredText、Jade、Docx、および Plain Text をサポートします。 SASS、Less、Stylus、CoffeeScript のコンパイルもサポートしています。 Blended には、組み込みの FTP アップローダーが組み込まれているため、Web サイトの展開が簡単になります。さらに、Blended は Python プラグイン システムをサポートしているため、強力にアップグレードできます。

インストール中

PyPi から Blended をインストールするには (推奨)、次のコマンドを実行します。

pip install blended

ソースから Blended をビルドしてインストールするには、次のコマンドを実行します。

git clone https://github.com/johnroper100/Blended.git

cd Blended

pip install .

ランニング

Blended をインストールした後に使用するには、次のコマンドを実行します。

blended init

これは、新しい Web サイトを立ち上げるのに役立ちます。助けが必要な場合は、次を実行してください。

blended --help

使用可能なすべてのコマンドが表示されます。

サイトの構築

Blended run で作成したサイトを構築するには

blended build

または

blended interactive (ファイル変更時のビルド用)

実行するどのコマンドでも、構築または表示に使用する代替の--outdir指定できます。たとえば、 source_outputフォルダーにビルドするには、 blended build --outdir source_outputを実行します。

config.pyファイル内で、 minify_cssとminify_js true に設定して、ビルド後に CSS ファイルと JS ファイルを最適化できます。

テンプレートの使用

blended install-template使用して、GitHub からテンプレートをインストールできます。

各 Blended Web サイトは 4 つのテンプレート ファイルを使用します。

• header.html (必須)
• footer.html (必須)
• home_page.html (必須ではありませんが、サイトの見栄えが良くなります)
• content_page.html (必須ではありませんが、サイトの見栄えが良くなります)
• nav(name).html (最大 6 つの異なる nav テンプレートを使用できます。たとえば、 navTest.htmlまたはnav_test.html )
• page_list_item.html (必須ではありません。使用すると、各ページ リスト項目のコンテンツが置き換えられます。変数{name} 、 {content} 、 {content_short} 、 {date} 、 {day} 、 {month} 、 {month_name}を含めることができます{year} 、 {path} )

これらのファイルには、生成される各セクションのマークアップを配置します。

ページを操作する場合、必要に応じて、拡張子を除いたテンプレート ファイルの名前をページの最初の行に追加し、その後 2 行目に少なくとも 5 つの+を追加することで、必要なテンプレート ( content_page.html以外) を指定できます。 。たとえば、特定のページにblog_page.htmlというテンプレートを使用したい場合は、次のようにします。

 blog_page
+++++

ページの上部にあります。必ず上部に配置してください。そうしないと機能しません。

構築中に値を取り込むためにテンプレートで使用できる変数がいくつかあります。

• {website_name}
• {website_description}
• {website_description_long} (著者の略歴などの長い説明に使用します)
• {author_name}
• {author_bio}
• {website_language}
• {website_license}
• {website_url}
• {page_content} (content_page.html テンプレート ファイルでのみ使用できます)
• {page_date} (ページが書き込まれた/変更された日付/時刻)
• {page_day} (ページが書かれた/変更された日)
• {page_month} (ページが作成/変更された月)
• {page_month_name} (ページが作成/変更された月の名前)
• {page_year} (ページが書かれた/変更された年)
• {relative_root} (現在のファイルの相対パスを返します)
• {random_number}
• {build_date}
• {build_time}
• {build_datetime}
• { (page_filename) _active} (ビルド時に、アクティブなページがタグ内のファイル名と等しい場合、タグはactive例に置き換えられます。 {getting-started.html_active} )
• {nav (name) } (ナビゲーションバーを配置するために使用します。ナビゲーションバーを追加するには、 navに何か他のものを加えて記述します。たとえば、 {nav2}または{nav_test} )
• {page_list} ( <ul><li><a href="page-name.html">page-name</a></li></ul>形式ですべてのページをリストします)
• {page_file} (ページの完全なファイル名。例: getting-started.html )
• {page_filename} (.html 拡張子を除いたページのファイル名。例: getting-started )
• {page_name} (現在のページの名前を指定します。ページ名がよりわかりやすくなります。たとえば、 getting-started.htmlはGetting Startedに変換されます)
• {page_folder} (現在のページのフォルダーの名前を指定します。フォルダー名がよりわかりやすくなります。たとえば、 getting-started Getting Startedに変換されます)
• {page_folder_orig} (現在のページのフォルダーの名前を指定します)
• {blended_version} (Blended の現在のバージョンを提供します)
• {blended_version_message} (Blended の現在のバージョンと素敵なメッセージが表示されます: Built with Blended v4.9 )

これらの変数をテンプレート内のどこに配置しても、それらは config.py ファイル内の値に置き換えられます。変数は中括弧内に収める必要があります。他の変数の内容の中に変数を入れることもできます。

プラグインの使用

PyPi からプラグインをインストールできます (例: pip install blended_google_analytics )。 blended install-plugin使用して GitHub からプラグインをインストールすることもできます。

プラグインを使用するには、 config.pyのpluginsリストにプラグインを含めます。

プラグインがテンプレート内で呼び出される場合は、例: {html_comment_box}をplugins = ["html_comment_box"]のようにプラグイン リストに挿入します。

複数のプラグインを同時に使用できます。 plugins = ["html_comment_box", "minify_images"]

カスタム変数の操作

config.py内には変数custom_variables = {}があります。これは、使用したいすべてのカスタム変数の辞書です。変数を追加するには、それを辞書項目として追加します。

以下にいくつかの例を示します。

custom_variables = {"software_name": "Blended"}

custom_variables = {"software_name": "Blended", "software_version": "5.0"}

WordPress からインポートする

WordPress から Web サイトと投稿をインポートできます。これを行うには、 Postsオプションを使用して WordPress からエクスポートし、Web サイトを生成するディレクトリにファイルをダウンロードします。

コマンドblended import-wpを実行すると、ファイルの名前とファイル パスの入力を求めるプロンプトが表示されます。ファイル名を入力すると、Blended がその情報を含む新しい Web サイトを作成します。

Blogger からインポートする

Blogger から投稿をインポートできます。これを行うには、 Backup Siteオプションを使用して Blogger からエクスポートし、Web サイトを生成するディレクトリにファイルをダウンロードします。

コマンドblended import-bloggerを実行すると、ファイルの名前とファイル パスの入力を求めるプロンプトが表示されます。ファイル名を入力すると、Blended がその情報を含む新しい Web サイトを作成します。

既製のテンプレート

blended install-template使用して GitHub からテンプレートをインストールできることに注意してください。

• シンプル (GitHub ページ)

• ブログ (GitHub ページ)

• ソフトウェア ショーケース (GitHub ページ)

プラグイン

• Disqus (GitHub ページ)

• Google アナリティクス (GitHub ページ)

• HTML コメント ボックス (GitHub ページ)

• Twitter カード (GitHub ページ)

• Facebook カード (GitHub ページ)

• Google フォント (GitHub ページ)

• ブートストラップのインポート (GitHub ページ)

Blended を使用するプロジェクト

• ブレンドウェブサイト

• The Art Of Illusion ウェブサイトのリニューアル

• 完全なレンダリング管理ダッシュボード (GitHub ページ)

• DVDStyler ウェブサイトのリニューアル (GitHub ページ)

• MakeHuman ウェブサイトのリニューアル (GitHub ページ)

• LilyPond ウェブサイトのリニューアル (GitHub ページ)