CouscousPHP/Couscous
CouscousPHP/Couscous has 836 GitHub stars and 102 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-20 01:08 UTC. Last push 2024-08-01.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Couscous is good.
开发工具README.md
原文layout: home
Couscous generates a GitHub pages website from your markdown documentation.
Everything is documented on couscous.io.
What follows is the documentation for contributors.
How Couscous works?
Couscous was designed to be as simple as possible. By embracing simplicity, it becomes extremely simple to extend.
Website generation
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: load thecouscous.ymlconfig fileInstallDependencies: install the dependencies (using yarn, npm or bower)LoadMarkdownFiles: load the content of all the*.mdfiles in memoryRenderMarkdown: render the markdown contentWriteFiles: write the in-memory processed files to the target directory- …
For 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.
Website deployment
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.
Contributing
See the CONTRIBUTING file.
License
Couscous is released under the MIT License.