Couscous从您的markdown文档生成一个GitHub页面的网站。(Couscous generates a GitHub pages website from your markdown documentation.)
Couscous从您的markdown文档生成一个GitHub页面的网站。她把Markdown文档变成漂亮的网站。 它是更强大有力的GitHub Pages。Couscous支持Markdown中的GitHub fenced代码块。Couscous在您的机器上需要PHP 5.4或更高版本。
Couscous不同于其他静态网站生成器如Sculpin或Jekyll。 这些是通用的静态网站生成器，有时是为博客，使用他们把文档放到网上是有些繁杂的。他们也都需要一个特定的目录布局，这与我们通常在我们的代码旁边存储文档不兼容。
Couscous是为简单而建。
它不需要你的目录布局，它只需要一个命令来预览网站和一个命令部署到GitHub页面。
Couscous特性：
对于喜欢功能列表的用户：
| 名稱與所有者 | CouscousPHP/Couscous |
|---|---|
| 主編程語言 | PHP |
| 編程語言 | PHP (語言數: 7) |
| 平台 | |
| 許可證 | Other |
| 創建於 | 2014-01-17 00:06:26 |
|---|---|
| 推送於 | 2024-08-01 22:05:46 |
| 最后一次提交 | 2023-02-21 11:54:36 |
| 發布數 | 40 |
| 最新版本名稱 | 1.10.0 (發布於 ) |
| 第一版名稱 | 0.1.0 (發布於 ) |
| 星數 | 840 |
|---|---|
| 關注者數 | 31 |
| 派生數 | 101 |
| 提交數 | 548 |
| 已啟用問題? | |
| 問題數 | 146 |
| 打開的問題數 | 43 |
| 拉請求數 | 101 |
| 打開的拉請求數 | 6 |
| 關閉的拉請求數 | 17 |
| 已啟用Wiki? | |
|---|---|
| 已存檔? | |
| 是復刻? | |
| 已鎖定? | |
| 是鏡像? | |
| 是私有? |
Couscous generates a GitHub pages website from your markdown documentation.
Everything is documented on couscous.io.
What follows is the documentation for contributors.
Couscous was designed to be as simple as possible. By embracing simplicity, it becomes extremely simple to extend.
The website generation is composed of a list of steps to process the Project model object:
interface Step
{
/**
* Process the given project.
*
* @param Project $project
*/
public function __invoke(Project $project);
}
Steps are very granular, thus extremely easy to write and test. For example:
LoadConfig: loads the couscous.yml config fileRunBowerInstallLoadMarkdownFiles: load the content of all the *.md files in memoryRenderMarkdown: render the markdown contentWriteFiles: write the in-memory processed files to the target directoryFor example, here is a step that would preprocess Markdown files to put the word "Couscous" in bold:
class PutCouscousInBold implements \Couscous\Step
{
public function __invoke(Project $project)
{
/** @var MarkdownFile[] $markdownFiles */
$markdownFiles = $project->findFilesByType('Couscous\Model\MarkdownFile');
foreach ($markdownFiles as $file) {
$file->content = str_replace('Couscous', '**Couscous**', $file->content);
}
}
}
Couscous uses PHP-DI for wiring everything together with dependency injection.
The full list of steps is configured in src/Application/config.php.
Couscous deploys by cloning (in a temp directory) the current repository, checking out the gh-pages branch, generating the website inside it, committing and pushing.
In the future, Couscous will support several deployment strategies.
See the CONTRIBUTING file.
Couscous is released under the MIT License.