次の記事では、ペリカンを見ていきます。 これは、単純なWebサイトまたはブログをセルフホストしたいPythonユーザーに適したオプションです。 カスタムWebサイトまたはブログの作成に興味がある場合は、今日利用できる多くのオプションがあります。 しかし、 あなたが静的なウェブページを提供したいなら、この静的なサイトビルダーはあなたのために役立つかもしれません。 これらのタイプのアプリケーションは、テンプレートを使用して、ユーザーが必要とするすべての静的ページを作成し、それらを関連するメタデータにリンクします。
使用する場合 Python 静的なHTMLページを生成するための何かを探しています、このジェネレーターを使用すると、その動作の内部を確認できます。 あなたが知っている言語を使うことはそれをより簡単にします。 Pythonが気に入らない場合は、他の言語を使用する他の静的サイトジェネレーターがあります。
Pelicanは、Pythonで記述された一般的に使用される静的サイトジェネレーターです。 東 直接サポート reStructuredText マークダウンをサポートできます、必要なパッケージがインストールされている場合。 すべてのタスクは、コマンドラインインターフェイスツールを介して実行されます(CLI)、これは、それに精通している人にとっては簡単です。 さらに、そのシンプルなクイックスタートツールにより、Webサイトの作成が非常に簡単になります。
ペリカンのインストールと基本構成
私はこのプログラムをUbuntu20.04でテストしています。 従うべき最初のステップは を作成する virtualenv ペリカンをインストールします。 これは、ターミナルを開いて(Ctrl + Alt + T)、その中のコマンドを使用することで実行できます。
mkdir test-sitio cd test-sitio python3.8 -m venv venv ./venv/bin/pip install --upgrade pip
pipを更新した後、次のことができます ペリカンをインストールする:
./venv/bin/pip install pelican
pelican-quickstartコマンドを実行します
インストールしたら、 PelicanクイックスタートCLIツールは基本的なレイアウトを作成します 開始できるようにいくつかのファイル。
簡単にするために、クイックスタートを実行するときに、タイトルと作成者の値を使用して回答しました N 記事のURLプレフィックスとページ付けに。 残りの質問については、 デフォルトを使用しました。 後で構成ファイルでこれらの設定を変更するのは非常に簡単です。 クイックスタートを実行できます コマンドで:
./venv/bin/pelican-quickstart
完了したら、設定の特定の側面を変更できます。 私たちはただしなければなりません お気に入りのテキストエディタでファイルpelicanconf.pyを開きます.
内部で次の行を探すことができます。
TIMEZONE = 'Europe/Paris'
そして、私たちはできます 興味のある国のタイムゾーンに変更します.
へ ソーシャルリンク設定を更新する、変数を探す必要があります ソーシャルメディア en ペリカンconf.py。 その中に、次のようにリンクを追加できます。
SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)
最後のコンマが重要であることに注意してください。 このコンマは、Pythonが変数が実際にセットであることを認識するのに役立ちます。 削除しないでください。
サーバーを起動します
サイトの基本がわかったので、クイックスタートでさまざまな目的のMakefileが作成されたことがわかります。 それらのXNUMXつは devserverは私たちのマシンで開発サーバーを起動できます 作成しているものすべてをプレビューできるようにします。 Makefileで使用されるCLIコマンドは、PATHの一部であると想定されているため、最初に virtualenvをアクティブ化する必要があります.
source ./venv/bin/activate make devserver
それが始まるとき、私たちはすることができます ブラウザを開いてURLにアクセスします http://localhost:8000 作成されたブログを表示します。
コンテンツを追加する
基本的なサイトができたので、いくつかのコンテンツを追加できます。 初め、 というファイルを作成します はじめまして コンテンツディレクトリ内(コンテンツ)サイトの.
私たちのお気に入りのテキストエディタで、 次の構造に従うテキストでこのファイルを作成します:
Bienvenid@ a este blog ###################### :date: 20210827 00:03 :tags: bienvenid@ :category: Intro :slug: bienvenida :author: ubunlog :summary: Documento bienvenida Bienvenid@ a este blog de prueba con Pelican. Esta es una pequeña página se va a mostrar como página estática. Pelican analiza automáticamente las líneas de metadatos (fecha, etiquetas, etc.).
ファイルを書き込んだ後、 devserverは、次のようなものを更新して生成する必要があります:
テストサイトをリロードします ブラウザで変更を確認します。
メタデータは自動的にページに追加されました。 そのうえ、 ペリカンは自動的にイントロカテゴリを検出し、トップナビゲーションにセクションを追加しました.
トピックを変更
上記のすべてに加えて、件名を簡単に変更できます。 リポジトリ内 ペリカン-テーマ、ユーザーが作成したさまざまなテーマを見つけることができます。 新しいテーマをテストするのは非常に簡単です。リポジトリからダウンロードするだけです。 それらをコンピューターに保存し、ファイルpelicanconf.pyにテーマへのパスを含む次の行を追加します:
THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"
devserverはその出力を再生成します。 ブラウザにWebページをリロードして、新しいテーマを表示します。
これはペリカンの簡単な紹介でした。 これはすべてローカルマシンで行われました。 他の人にあなたのサイトを見てもらいたい場合は、事前に生成されたHTMLファイルをサーバーにアップロードする必要があります。 の出力を詳しく見ると ペリカン-クイックスタート、FTP、SSH、S3、さらにはGitHubページを使用するためのオプションが表示されます。
それができる このジェネレーターの詳細については、 プロジェクトのウェブサイト またはで GitHubリポジトリ.