beromir / neos-markdown

Neos CMS 的 Markdown 渲染器。

安装: 2

依赖: 0

建议: 0

安全: 0

星标: 1

关注者: 2

分支: 0

公开问题: 0

类型:neos-package

v1.0.0 2022-06-16 11:45 UTC

This package is not auto-updated.

Last update: 2024-09-20 20:41:42 UTC


README

功能

安装

在您的站点包中运行以下命令

composer require --no-update beromir/neos-markdown

然后在项目根目录中运行 composer update

配置

您可以在全局范围内启用或禁用以下扩展

Beromir:
    Markdown:
        extensions:
            # GitHub-Flavored Markdown
            gfm: true
            externalLinks: true

用法

独立节点类型

您可以在您的页面上使用独立的 Markdown 节点类型来渲染 Markdown。默认情况下,节点类型包含启用或禁用扩展的选项。Fusion 组件可以在您的站点包中重写。例如,您可以在 HTML 输出中包含一些 CSS 类名。

将 Markdown 编辑器添加到自定义节点类型

该包包含两个混入

  • 编辑器混入
  • 选项混入

将混入添加到您的节点类型

'Vendor.Site:Content.CustomNodeType':
    superTypes:
        'Neos.Neos:Content': true
        'Beromir.Markdown:Mixin.MarkdownEditor': true
        'Beromir.Markdown:Mixin.MarkdownSettings': true

设置混入是可选的。它允许您为节点类型启用或禁用 CommonMark 扩展。如果您不使用混入,则使用全局设置。

您有两种方式在 Fusion 组件中渲染 Markdown。

Fusion 对象

renderer = afx`
<div>
    <Beromir.Markdown:Markdown/>
</div>
`

Eel 辅助工具

html = ${Beromir.Markdown.Markdown.convertMarkdown(props.markdown)}