Pythonベースの静的サイトジェネレーターであるPelican

ペリカンについて

次の記事では、ペリカンを見ていきます。 これは、単純な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リポジトリ.


コメントを残す

あなたのメールアドレスが公開されることはありません。 必須フィールドには付いています *

*

*

  1. データの責任者:MiguelÁngelGatón
  2. データの目的:SPAMの制御、コメント管理。
  3. 正当化:あなたの同意
  4. データの伝達:法的義務がある場合を除き、データが第三者に伝達されることはありません。
  5. データストレージ:Occentus Networks(EU)がホストするデータベース
  6. 権利:いつでも情報を制限、回復、削除できます。