Maison > cadre php > PensezPHP > Comment utiliser Markdown dans ThinkPHP6

Comment utiliser Markdown dans ThinkPHP6

WBOY
Libérer: 2023-06-20 23:00:13
original
913 Les gens l'ont consulté

Dans le développement de l'ère Internet moderne, l'écriture de documents est progressivement passée de balises HTML encombrantes à une syntaxe Markdown plus simple et plus facile à lire et à écrire. ThinkPHP6 utilise un moteur de modèles très flexible et fournit des extensions Markdown pratiques, ce qui rend très facile l'écriture et l'affichage de fichiers Markdown dans les projets.

Qu'est-ce que Markdown

Markdown est un langage de balisage léger qui peut convertir rapidement des documents écrits en texte brut en HTML pour une lecture en ligne. La syntaxe Markdown est relativement simple et facile à retenir et est principalement divisée en plusieurs parties telles que des titres, des paragraphes, des listes, des blocs de code, des liens et des images.

Par exemple, voici un exemple simple de Markdown :

# 标题一

这是一个段落。

## 标题二

这是一个无序列表:
- 列表项一
- 列表项二

这是一个代码块:
Copier après la connexion

echo "Hello, world!";

这是一个链接:[GitHub](https://github.com)

这是一张图片:
![图片](https://example.com/image.jpg)
Copier après la connexion

Lorsque vous utilisez Markdown pour rédiger des documents, il vous suffit d'écrire le texte selon les spécifications grammaticales correspondantes, sans avoir à Pour prendre en compte la complexité, les balises HTML réduisent considérablement la complexité de l'écriture.

Utilisation de Markdown dans ThinkPHP6

Après la version ThinkPHP6.0, il existe une prise en charge intégrée pour Markdown. Il vous suffit d'installer l'extension et de configurer le moteur de modèles pour écrire et restituer des documents à l'aide de Markdown.

Installez l'extension

Tout d'abord, vous devez installer l'extension league/commonmark. La commande spécifique est la suivante : league/commonmark扩展,具体命令如下:

composer require league/commonmark
Copier après la connexion

该扩展提供了对Markdown语法的解释和转换功能,可轻松将以Markdown格式编写的文件转化为HTML。

配置模板引擎

在完成扩展安装后,需要进一步在模板引擎中配置Markdown的解析器。

打开config/view.php文件,添加如下内容:

use LeagueCommonMarkCommonMarkConverter;

return [
    // ...
    'tpl' => [
        'type' => 'Think',
        // ...
        'config' => [
            // ...
            'markdown' => function ($markdown, $vars = []) {
                $converter = new CommonMarkConverter();
                $html = $converter->convertToHtml($markdown);
                return $html;
            },
            // ...
        ],
    ],
];
Copier après la connexion

以上代码中,markdown键表示为Markdown文件解析的回调函数,该函数将传入两个参数:第一个参数为Markdown格式的文本,第二个参数为可选的模板变量。回调函数中通过league/commonmark扩展创建一个Markdown解析器,将Markdown格式文本解析成HTML格式文本。

使用Markdown

经过以上的配置后,即可在ThinkPHP6项目中愉快地使用Markdown语法来写文档了。

例如,我们可以在控制器中,使用view方法渲染Markdown文件:

public function index()
{
    $markdown = file_get_contents('path/to/document.md');
    return view($markdown, [], ['content_type' => 'text/markdown']);
}
Copier après la connexion

在渲染Markdown文件时,需要在第三个参数中指定响应头Content-Typetext/markdownrrreee

Cette extension fournit des fonctions d'interprétation et de conversion pour la syntaxe Markdown, et peut facilement écrire au format Markdown Convertir le fichier en HTML.

Configurer le moteur de modèles

Après avoir terminé l'installation de l'extension, vous devez configurer davantage l'analyseur Markdown dans le moteur de modèles. 🎜🎜Ouvrez le fichier config/view.php et ajoutez le contenu suivant : 🎜rrreee🎜Dans le code ci-dessus, la touche markdown représente la fonction de rappel pour l'analyse du fichier Markdown, qui passera Entrez deux paramètres : le premier paramètre est du texte au format Markdown et le deuxième paramètre est une variable de modèle facultative. Dans la fonction de rappel, un analyseur Markdown est créé via l'extension league/commonmark pour analyser le texte au format Markdown en texte au format HTML. 🎜🎜Utiliser Markdown🎜🎜Après la configuration ci-dessus, vous pouvez volontiers utiliser la syntaxe Markdown pour écrire des documents dans le projet ThinkPHP6. 🎜🎜Par exemple, nous pouvons utiliser la méthode view dans le contrôleur pour restituer un fichier Markdown : 🎜rrreee🎜Lors du rendu d'un fichier Markdown, vous devez spécifier l'en-tête de réponse Content-Type dans le troisième paramètre est text/markdown afin que le navigateur puisse analyser correctement le texte Markdown. 🎜🎜Résumé🎜🎜Grâce aux étapes ci-dessus, nous pouvons facilement utiliser le texte Markdown pour écrire et afficher des documents de projet dans le projet ThinkPHP6. Le texte Markdown est concis et facile à comprendre, facile à lire et à maintenir, et convient comme méthode de saisie et de sortie de documents. La combinaison de Markdown avec ThinkPHP6 peut non seulement améliorer l'efficacité de la rédaction de documents, mais également fournir des effets de sortie plus beaux et plus faciles à lire. C'est une excellente solution et une excellente pratique. 🎜

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Étiquettes associées:
source:php.cn
Déclaration de ce site Web
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn
Tutoriels populaires
Plus>
Derniers téléchargements
Plus>
effets Web
Code source du site Web
Matériel du site Web
Modèle frontal