md2html php

帶有PHP的降價網站

該項目是一個平坦的網站，使用PHP動態提供Markdown文件。管理網站內容有很多選擇，但是我更喜歡我的個人網站的這種方法，因為：

• 沒有構建步驟：與靜態站點生成器不同，當請求頁面時，HTML是從Markdown Files動態生成的，因此無需構建步驟。
• 沒有數據庫：這是一個平坦的網站，因此存儲內容不需要數據庫。
• 易於安裝：使用git克隆此回購
• 輕鬆備份：只需匯總Web文件夾
• 簡單的創作：只需使用index.md創建一個文件夾
• 清潔URL：頁面URL是文件夾路徑

特徵

• 標題的自動錨點鏈接
• 語法在代碼塊中突出顯示
• 使用![](TOC)添加目錄
• 使用![](YouTubeURL)嵌入YouTube視頻
• 模板文件是HTML易於自定義的
• 降價標題和桌子的樣式類似於github
• 動態的站點地圖
• RSS Feed的動態生成
• 自定義功能很容易添加

示例網站

• https://swharden.com
• https://swharden.com/pyabf
• https://swharden.com/csharpdatavis
• https://swharden.com/software/ljpcalc

開發人員注意

安裝

步驟1：使用git克隆此存儲庫在您的網絡文件夾之外。我建議/var/www/md2html

步驟2：將資源文件夾鏈接到可訪問的URL

 ln -ls /var/www/md2html/resources /var/www/html/md2html-resources

步驟3：將QuickStart Demo文件夾複製到您的Web文件夾，您的網站將實時！

步驟4：要創建新頁面，請使用index.md創建子文件夾

在Docker開發

該存儲庫有一個現成的演示站點。

運行docker-compose up -d ，然後轉到http：// localhost：8081

降價標頭

MarkDown文件可以具有包含前面事項的可選標頭，以自定義模板中{{mustache}}文本替換的內容。默認替換在settings.php中定義，並且標題中定義的任何值覆蓋了設置文件中定義的值。

 ---
title: this text becomes the title element in the header
description: this text becomes header metadata for search engines to display
---

# My Markdown Article

The rest of the ***Markdown*** text goes here...

路由請求

該存儲庫使用.htaccess告訴Apache（帶MOD_REWRITE）將請求路由到包含index.md文件夾到本地PHP腳本來處理它們。如果您不使用apache或mod_rewrite，請使用類似的任何系統來路由目錄索引請求。

連續部署GitHub動作

可以使用git將平整文件網站克隆到網絡服務器上，然後PHP可以執行git pull以更新內容。通過配置github操作來製作HTTP請求，每次將新提交都推到存儲庫時，都可以執行PHP更新腳本，可以將網站連續並自動與GitHub存儲庫保持同步。

• 克隆此存儲庫在Web根部外面的文件夾中
• 象徵性地將wwwroot鏈接到可訪問的路徑
• 在GitHub項目中創建一個秘密的API_KEY
• 將密鑰存儲在api.key中的根文件夾中（CHMOD 400 ）
• 將GITHUB操作配置為HTTP請求deploy.php時使用新提交時，使用API_KEY作為攜帶者令牌（請參閱Deploy.yml）

替代純Python靜態站點生成器

在使用此基於PHP的系統幾個月後，我越來越喜歡它的大型網站，上面有100頁的頁面，但是對於只有幾頁的非常小的網站，就很麻煩地解僱Docker實例，只是為了進行小頁面編輯。

我創建了palila來滿足這一需求 - 一個小的python腳本將index.md轉換為index.html，可以在本地（編輯）或遠程運行（部署時）運行。