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，可以在本地（编辑）或远程运行（部署时）运行。