judaicalink site

犹太链接网站

该网站是使用 Hugo 生成的。 Hugo是一个静态网站生成器，使用Markdown网站和模板来编译静态网站。

什么是 JudaicaLink？

安装

克隆项目： git clone https://github.com/judaicalink/judaicalink-site.git 。

进入目录： cd judaicalink-site 。

安装hugo（见下文）。

视窗

只需下载 Hugo 可执行文件（服务器上当前使用的版本：0.104.3）。

您必须在 PATH 下的环境变量中添加hugo：

例如：C:Users你的名字hugo_0.31.1_Windows-64bit

要检查安装是否有效，您可以在命令提示符中键入hugo help 。您应该收到包含hugo 能够执行的多个命令的响应。

-> 如需更详细的说明，请查看hugo提供的Windows安装指南

在命令提示符下，转到克隆存储库的主目录（README.md 文件所在的位置）并执行命令hugo server 。

例如：C:UsersYourNamejudaicalink-site>hugo server

之后就可以在本地浏览网站了 http://localhost:1313

Linux

Ubuntu： sudo apt update && sudo apt install hugo 。

拱门： sudo pacman -S hugo 。

Fedora、RedHat： sudo pacman -S hugo

使用以下命令验证安装： hugo --version 。

操作系统

使用brew安装hugo brew install hugo 。

使用以下命令验证安装： hugo --version 。

跑步

使用 Hugoserve 直接在本地计算机上为hugo serve 。它打开一个网络服务器。检查终端的链接和路径。

还要检查是否有错误。

编译

如果您想编译源代码并生成实时站点，只需运行hugo即可。

这会生成static文件和public 。

如果您想将站点编译到特定文件夹，只需使用： hugo -d <your-destination> 。

现在您可以使用 Apache2 或 NGINX 等网络服务器来提供页面。

将public文件夹和static文件夹复制到服务目录，或者将sites-available中的目录添加到位置指令。

也不要伪造提供static文件夹。

更新网站

只需获取并拉取网站的最新版本即可， git fetch和git pull 。再次编译站点。

Docker镜像

如果您想构建 docker 映像，请克隆存储库并运行docker build -t judaicalink-site .在存储库的根目录中。

要运行该映像，请使用docker run -d -p 80:80 judaicalink-site 。

故障排除

检查 Markdown 语法是否正确。

如果您的更改未按预期显示，请观察控制台是否有错误。

在本地提供站点并检查更改。

清除浏览器的缓存。

最后

完成后，将更改提交到分叉存储库并发送拉取请求。