Rumah  >  Artikel  >  rangka kerja php  >  Cara menggunakan Markdown dalam ThinkPHP6

Cara menggunakan Markdown dalam ThinkPHP6

WBOY
WBOYasal
2023-06-20 23:00:13898semak imbas

Dalam perkembangan era Internet moden, penulisan dokumen telah berubah secara beransur-ansur daripada tag HTML yang menyusahkan kepada sintaks Markdown yang lebih ringkas dan mudah untuk dibaca dan ditulis. ThinkPHP6 menggunakan enjin templat yang sangat fleksibel dan menyediakan sambungan Markdown yang mudah, menjadikannya sangat mudah untuk menulis dan memaparkan fail Markdown dalam projek.

Apa itu Markdown

Markdown ialah bahasa markup ringan yang boleh menukar dokumen teks biasa kepada HTML dengan pantas untuk bacaan dalam talian. Sintaks penurunan harga agak mudah dan mudah diingati, dan terbahagi terutamanya kepada beberapa bahagian seperti tajuk, perenggan, senarai, blok kod, pautan dan gambar.

Sebagai contoh, berikut ialah contoh Markdown yang mudah:

# 标题一

这是一个段落。

## 标题二

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

这是一个代码块:

gema "Hello, world!";

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

这是一张图片:
![图片](https://example.com/image.jpg)

Apabila menggunakan Markdown untuk menulis dokumen, ikut sahaja Just compose teks mengikut spesifikasi tatabahasa yang sepadan Tidak perlu mempertimbangkan tag HTML yang kompleks, yang sangat mengurangkan kerumitan penulisan.

Menggunakan Markdown dalam ThinkPHP6

Selepas versi ThinkPHP6.0, terdapat sokongan terbina dalam untuk Markdown Anda hanya perlu memasang sambungan dan mengkonfigurasi enjin templat untuk menulis dan memaparkan dokumen menggunakan Markdown .

Pasang sambungan

Pertama, anda perlu memasang sambungan league/commonmark Perintah khusus adalah seperti berikut:

composer require league/commonmark

Sambungan ini menyediakan fungsi tafsiran dan penukaran untuk Markdown. sintaks, yang boleh dengan mudah Menukar fail yang ditulis dalam format Markdown kepada HTML.

Mengkonfigurasi enjin templat

Selepas melengkapkan pemasangan sambungan, anda perlu mengkonfigurasi lagi penghurai Markdown dalam enjin templat.

Buka fail config/view.php dan tambah kandungan berikut:

use LeagueCommonMarkCommonMarkConverter;

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

Dalam kod di atas, kekunci markdown mewakili fungsi panggil balik untuk penghuraian fail Markdown, yang akan lulus dalam dua parameter : Satu parameter ialah teks dalam format Markdown, dan parameter kedua ialah pembolehubah templat pilihan. Dalam fungsi panggil balik, penghurai Markdown dibuat melalui sambungan league/commonmark untuk menghuraikan teks format Markdown ke dalam teks format HTML.

Gunakan Markdown

Selepas konfigurasi di atas, anda boleh menggunakan sintaks Markdown untuk menulis dokumen dalam projek ThinkPHP6.

Sebagai contoh, kita boleh menggunakan kaedah view dalam pengawal untuk memaparkan fail Markdown:

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

Apabila memaparkan fail Markdown, anda perlu menentukan pengepala respons Content-Type dalam parameter ketiga kepada text/markdown supaya penyemak imbas boleh menghuraikan teks Markdown dengan betul.

Ringkasan

Melalui langkah di atas, kita boleh menggunakan teks Markdown dengan mudah untuk menulis dan memaparkan dokumen projek dalam projek ThinkPHP6. Teks penurunan harga adalah ringkas dan mudah difahami, mudah dibaca dan diselenggara, dan sesuai sebagai kaedah untuk input dan output dokumen. Menggabungkan Markdown dengan ThinkPHP6 bukan sahaja boleh meningkatkan kecekapan penulisan dokumen, tetapi juga memberikan kesan output yang lebih cantik dan mudah dibaca Ia merupakan penyelesaian dan amalan yang sangat baik.

Atas ialah kandungan terperinci Cara menggunakan Markdown dalam ThinkPHP6. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

Kenyataan:
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn