如何安装并开始使用 Sculpin

金钱(警告)

** 状态:** 被贬值

如果您目前正在运行运行 Ubuntu 12.04 的服务器,我们强烈建议升级或迁移到支持的 Ubuntu 版本:

** 原因:** Ubuntu 12.04 已于 2017 年 4 月 28 日到期(EOL)并且不再收到安全补丁或更新。

** 相反,请参见:** 本指南可能仍然有用作为参考,但可能不会在其他Ubuntu版本上工作. 如果可用,我们强烈建议使用为您正在使用的Ubuntu版本撰写的指南。

介绍


Sculpin 是一个基于 PHP 的静态网站生成器,它将 Twig 或 HTML 模板以及标记下写的内容转换为易于部署的静态网站。

在本教程中,我们将安装Sculpin在运行Ubuntu 12.04的VPS上,并开始使用它,我们将看到如何从头开始项目,如何生成静态文件,以及如何使用其内部Web服务器将文件传输到浏览器中。

安装


我们需要做的第一件事是照顾我们以后需要的一些要求,所以运行以下命令来安装它们. 如果您已经有任何一个,您可以从命令中删除它们。

1apt-get update
2apt-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,让我们将其移动到 /bin文件夹:

mv sculpin.phar ~/bin/sculpin

如果您尚未在用户的 root 文件夹中找到 /bin 文件夹,请先继续创建它,最后将其添加到 bash. 打开.bashrc 文件:

nano ~/.bashrc

然后插入以下行:

PATH=$PATH:$HOME/bin

然后运行以下命令来源 .bashrc 文件,并确保您的更改粘贴:

源 ~/.bashrc

要测试命令是否有效,只需从任何文件夹(‘sculpin’)运行 sculpin 命令,您应该在命令终端中获得 Sculpin 帮助。

你的第一个Sculpin网站


关于Sculpin的一点是,它配备了内置的Web服务器,可以将其页面服务到Web上。 要在行动中看到这一点,让我们在用户的 root 文件夹中创建我们的简单网站,而不是Apache root 目录。 让我们从我们的第一个项目文件夹开始:

mkdir mysite cd mysite mkdir source cd source

现在我们有项目文件夹(mysite/)和另一个文件夹(源/)。后者是您将您的网站内容放置的地方,所以让我们在那里创建一个简单的 Hello World 。在 /source文件夹中创建 index.md 文件并粘贴下列内容:



Hello World

我们所使用的格式为 Hello World ,称为 markdown,上面的行是用于 YAML 格式化。 有关 markdown 语法的更多信息,请点击 此页面

1sculpin generate --watch --server

这将生成您的开发网站. 注意当前内容的变化,如果您对文件进行一些更新,并创建一个文件夹,通过服务器端口服务文件. 所以现在您可以访问您的网站在ip-address:8000。 您应该看到 Hello World 在标题标签之间打印在页面上。 要停止服务器(如在终端中提到的),只需运行CTRL + C。

您会注意到,在 mysite/ 文件夹中,您现在有另一个名为 output_dev/ 的文件夹,其中存储了等同的 html 文件。

1sculpin generate --watch --server --env=prod

这将生成 output_prod / 文件夹和内部所需的文件,然后您可以同步此文件夹与您的 Apache,以便您可以使用适当的服务器将网站页面交付到浏览器中。

假设您希望该网站可以从 Apache 的默认 /var/www/ 文件夹(Web 服务器根目录)中访问,您可以执行以下操作。

1cd output_prod

然后运行以下rsync命令,从这里同步文件与 /var/www 文件夹:

1rsync -azv * /var/www

现在,您可以直接访问该网站,转到您的VPS IP地址(如果您没有更改任何虚拟主机配置),并且只要从同一个文件夹执行这个命令,每次您对您的网站进行任何更改并生成新的HTML文件。

Twig 和 布局


Sculpin 使用 Twig 为其布局,这是一个强大的 PHP 模板系统. 在 [DigitalOcean] 上有关于 Twig 的介绍文章(https://www.digitalocean.com/community/articles/how-to-install-and-get-started-with-twig-on-a-vps). 正如我们所看到的那样,在页面上打印的内容位于源 / 文件夹中 - 这是您在 markdown 中写的内容。

在源 / 文件夹中,创建一个名为 _views 的文件夹(命名是一种最佳做法):

1mkdir _views

在这个文件夹中,创建一个名为 main.html 的文件,在这里我们可以宣布我们想要的所有主页的HTML + Twig内容块,这将使我们的网站内容。所以,例如,插入以下内容:

My first Sculpin site
{% block content %}{% endblock %}

现在编辑我们之前创建的 index.md 文件,而不是这个:



Hello World

此分類上一篇:

1# Hello World

现在,如果您再次运行 sculpin 命令(您可以暂时离开手表):

1sculpin generate  --server

您应该看到,您写的标记文件(index.md)自动注入到我们在 main.html 模板中定义的 Twig 内容块中,因为我们在文件顶部制作了 YAML 声明。

博客测试


如果你想了解更多关于你可以用Sculpin做的事情,你应该得到Sculpin博客骨骼,这可以帮助你更好地了解它是如何工作的。你可以使用Git为此:

cd ~ git克隆HTTPS://github.com/sculpin/sculpin-blog-skeleton.git blog cd blog

现在我们需要 Sculpin 使用 Composer 安装项目依赖性,所以只需执行以下命令:

sculpin install

接下来,您可以使用服务器选项运行sculpin generate函数,然后返回浏览器以查看您刚刚创建的博客网站,然后您可以探索构成博客的文件,并查看它们如何一起工作。

然后创建一个新的文件:

nano 2020-02-07-my-post.md

把下列内容放在里面并保存:


标题: 我的帖子

您好世界。

然后继续,再生成并检查博客,你会看到你的新帖子。

结论


Sculpin 是一个有趣的静态网站生成器,它使用 markdown 用于快速内容格式化和 Twig 用于惊人的模板,以便您轻松部署静态网站。

Article Submitted by: Danny
Published At
Categories with 技术
comments powered by Disqus