basteyy/static-markdown-pages

1.0.0 2021-12-15 15:20 UTC

This package is auto-updated.

Last update: 2024-09-15 21:02:28 UTC


README

一个用于在项目中使用静态Markdown页面的工具。

设置

composer require basteyy/static-markdown-pages

用法

首先您需要拥有自己的Markdown页面。在以下示例中,我期望您在 /var/www/storage/my_pages/ 目录下存储了一些文件。

$ ls /var/www/storage/my_pages/
my_file_1.md
my_file_2.md
fancy-third-file.md

每个页面需要在文档开头包含一些元数据。

例如 fancy-third-file.md 的内容

$ cat /var/www/storage/my_pages/fancy-third-file.md
title: I'm the fancy third file!
url: /fancy-third/
author: John Doe
===

# Example Markdown Page

As you can see .. this is markdown
/** @var \basteyy\StaticMarkdownPage\Archive $staticPages */
$staticPages = new \basteyy\StaticMarkdownPage\Archive('/var/www/storage/my_pages/');

要获取fancy-third-file,您需要将url传递给getByUrl方法

/** @var \basteyy\StaticMarkdownPage\Archive $staticPages */
/** @var \basteyy\StaticMarkdownPage\Page $page */
$page = $staticPages->getByUrl('/fancy-third/');

现在您可以打印文件

/** @var \basteyy\StaticMarkdownPage\Archive $staticPages */
/** @var \basteyy\StaticMarkdownPage\Page $page */
echo $page->getHtml();

就这样。