Sculpinをインストールして使用を開始する方法
ステータス:非推奨
この記事では、サポートされなくなったバージョンのUbuntuについて説明します。 現在Ubuntu12.04を実行しているサーバーを運用している場合は、サポートされているバージョンのUbuntuにアップグレードまたは移行することを強くお勧めします。
理由:
Ubuntu 12.04は2017年4月28日に保守終了(EOL)に達しました and no longer receives security patches or updates. This guide is no longer maintained.
代わりに参照してください:このガイドは参照として役立つ場合がありますが、他のUbuntuリリースでは機能しない場合があります。 可能な場合は、使用しているUbuntuのバージョン用に作成されたガイドを使用することを強くお勧めします。 ページ上部の検索機能を使用して、より新しいバージョンを見つけることができます。
序章
Sculpinは、PHPベースの静的サイトジェネレーターです。 TwigまたはHTMLテンプレートを、マークダウンで記述されたコンテンツと一緒に、簡単に展開できる静的サイトに変換します。
このチュートリアルでは、Ubuntu 12.04を実行しているVPSにSculpinをインストールし、使用を開始します。 プロジェクトを最初から開始する方法、静的ファイルを生成する方法、および内部Webサーバーを使用してファイルをブラウザーに配信する方法について説明します。 さらに、Sculpinで構築された既成のブログサイトを開始し、それに新しいブログ投稿を追加する方法を紹介します。
インストール
最初に行う必要があるのは、後で必要になる要件のいくつかを処理することです。 したがって、次のコマンドを実行してインストールします。 それらのいずれかがすでにある場合は、コマンドから削除するだけです。
apt-get update
apt-get install php5-common php5-cli git-core php5-curl
次に、Sculpin PHP実行可能ファイル(.pharファイル)をダウンロードします。
curl -O https://download.sculpin.io/sculpin.phar
次に、実行可能にする必要があります。
chmod +x sculpin.phar
ここで、仮想サーバー上の任意のフォルダーからSculpinを実行するために、Sculpinを/binフォルダーに移動しましょう。
mv sculpin.phar ~/bin/sculpin
ユーザーのルートフォルダーに/binフォルダーがまだない場合は、先に進んで作成してください。 そして最後に、それをbashに追加しましょう。 .bashrcファイルを開きます。
nano ~/.bashrc
そして、次の行に貼り付けます。
PATH=$PATH:$HOME/bin
次に、次のコマンドを実行して.bashrc
ファイルを入手し、変更が反映されていることを確認します。
source ~/.bashrc
そして、それはそれを行う必要があります。 コマンドが機能するかどうかをテストするには、任意のフォルダー(sculpin
)からsculpinコマンドだけを実行すると、コマンドターミナルでSculpinヘルプが表示されます。
あなたの最初のSculpinサイト
Sculpinの1つは、ページをWebに提供できるWebサーバーが組み込まれていることです。 これが実際に動作することを確認するために、Apacheルートディレクトリではなく、ユーザーのルートフォルダに単純なサイトを作成しましょう。 最初のプロジェクトフォルダから始めましょう:
mkdir mysite
cd mysite
mkdir source
cd source
これで、プロジェクトフォルダー(mysite /)とその中に別のフォルダー(source /)ができました。 後者は、サイトのコンテンツを配置する場所です。 それでは、そこに単純な HelloWorldのものを作成しましょう。 /sourceフォルダーにindex.mdファイルを作成し、以下を貼り付けます。
---
---
# Hello World
Hello World を記述している形式はマークダウンと呼ばれ、上の行はYAML形式用です。 マークダウン構文の詳細については、このページを確認してください。 ファイルを保存して終了し、mysite /フォルダーに戻って、次のコマンドを実行します。
sculpin generate --watch --server
これにより、開発サイトが生成されます。 ファイルを更新する場合は、コンテンツの現在の変更を監視し、サーバーポートを介してファイルを提供するフォルダーを作成します。 これで、ip-address:8000でサイトにアクセスできます。 ページのヘッダータグの間にHelloWorldが印刷されているはずです。 サーバーを停止するには(ターミナルで説明されているように)、CTRL+Cを実行するだけです。
mysite /フォルダー内に、同等のhtmlファイルが保存されているoutput_dev/という別のフォルダーがあることに気付くでしょう。 本番ファイルを生成するには、--env=prod
タグをsculpingenerateコマンドに追加します。
sculpin generate --watch --server --env=prod
これにより、output_prod/フォルダーと必要なファイルが内部に生成されます。 次に、このフォルダーをApacheと同期して、適切なサーバーを使用してサイトページをブラウザーに配信できるようにします。 その方法を簡単に見てみましょう。
Apacheのデフォルトの/var/ www /フォルダー(Webサーバーのルートディレクトリ)からサイトにアクセスできるようにする場合は、次の操作を実行できます。 output_prod/フォルダーに移動します。
cd output_prod
そして、次のrsync
コマンドを実行して、ここからのファイルを/ var/wwwフォルダーと同期します。
rsync -azv * /var/www
これで、VPS IPアドレスにアクセスするだけでサイトに直接アクセスできます(仮想ホストの構成を変更していない場合)。 また、サイトに変更を加えて新しいhtmlファイルを生成するときはいつでも、同じフォルダーからこのコマンドを実行するだけです。
小枝とレイアウト
Sculpinは、PHP用の強力なテンプレートシステムであるTwigをレイアウトに使用しています。 DigitalOceanにTwigに関する紹介記事があります。 私たちが見たように、ページに印刷されるものはソース/フォルダーにあります-これはマークダウンで書かれたコンテンツです。 次に、そのindex.mdファイルのコンテンツが挿入されるレイアウトを作成しましょう。
source /フォルダー内に、 _views というフォルダーを作成します(名前付けはベストプラクティスのようなものです)。
mkdir _views
このフォルダ内に、main.htmlというファイルを作成します。 ここでは、必要なすべてのメインページHTML+サイトコンテンツをレンダリングするTwigコンテンツブロックを宣言できます。 したがって、たとえば、次の中に貼り付けます。
<html>
<head><title>My first Sculpin site</title></head>
<body><div class="content">{% block content %}{% endblock %}</div></body>
</html>
ここで、前に作成した index.md ファイルを編集します。代わりに、次のようにします。
---
---
# Hello World
これを貼り付けます:
---
layout: main
---
# Hello World
ここで、sculpinコマンドを再度実行すると(今のところウォッチを省略できます):
sculpin generate --server
作成したマークダウンファイル( index.md )が、ファイルの先頭でYAML宣言を行ったため、main.htmlテンプレートで定義したTwigコンテンツブロックに自動的に挿入されていることがわかります。 。 きちんとした。
テスト用のブログ
Sculpinで何ができるかについてもっと知りたい場合は、Sculpinブログスケルトンを入手して、それがどのように機能するかをよりよく理解するのに役立ててください。 これにはgitを使用できます:
cd ~
git clone https://github.com/sculpin/sculpin-blog-skeleton.git blog
cd blog
次に、Composerを使用してSculpinにプロジェクトの依存関係をインストールさせる必要があります。 したがって、次のコマンドを実行するだけです。
sculpin install
次に、サーバーオプションを指定してsculpin generate
関数を実行し、ブラウザーに戻って、作成したばかりのブログサイトを表示できます。 次に、ブログを構成するファイルを調べて、それらがどのように連携するかを確認できます。 さらに、ブログに新しい投稿を追加できます。 _posts/フォルダーに移動します。
cd source/_posts
そして、新しいファイルを作成します。
nano 2020-02-07-my-post.md
以下を中に貼り付けて保存します。
---
title: My post
---
# Hello world.
次に、先に進んで再度生成し、ブログをチェックしてください。 そこに新しい投稿が表示されます。
結論
Sculpinは興味深い静的サイトジェネレーターであり、マークダウンを使用してコンテンツをすばやくフォーマットし、Twigを使用して静的サイトを簡単に展開できる素晴らしいテンプレートを作成します。 プロジェクトがどのように見えるか、どのように開始するか、そしてSculpinで構築されたすでに作成されたブログサイトがどのように見えるかを見てきました。