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 語法是否正確。

如果您的變更未如預期顯示，請觀察控制台是否有錯誤。

在本地提供網站並檢查變更。

清除瀏覽器的快取。

最後

完成後，將變更提交到分叉儲存庫並發送拉取請求。