Markdown là một ngôn ngữ đánh dấu phổ biến đang được nhiều trang web lớn sử dụng (trong đó có Github) vậy làm thể nào để dịch một đoạn chữ thô markdown bằng PHP ?
Đọc thêm: http://blog.dinhquochan.com/php/better-markdown-parse-in-php.html
Introduce
Markdown là một ngôn ngữ đánh dấu phổ biến đang được nhiều trang web lớn sử dụng (trong đó có Github). Chính vì thế mình giới thiệu cho các bạn một thư viện PHP hỗ trợ dịch text thô markdown phổ biến được nhiều người sử dụng đó là Parsedown - Better Markdown Parser in PHP.
Features
- Tốc độ nhanh
- GitHub flavored
- Có thể mở rộng
- Hoạt động tốt trên PHP v5.3 đến v5.6
- Markdown Extra extension
How to install
Via composer
Nếu bạn chưa biết Composer là gì có thể xem tại đây: What is Composer ?
Bạn mở composer.json
trong thư mục dự án của bạn, thêm vào gói Parsedown
trong phần require
như sau:
"require":
{
"erusev/parsedown": "*"
}
Sau đó bạn mở CMD hoặc Terminal lên thực thi trong thư mục đó với câu lệnh composer install
hoặc composer update
nếu đã chạy composer trước đó.
Kế tiếp bạn chỉ cần chèn Autoloading
của Composer và gọi Parsedown :
include_once './vendor/autoload.php';
Vậy là ta đã xong bước cài đặt.
Via direct method
Đầu tiên bạn tải về: Parsedown Latest (Phiên bản tính đến thời điểm của bài viết là 1.6.0)
Sau khi tải về bạn mở ra sẽ có thư mục, bạn vào thư mục đó và chỉ quan tâm tệp tin: Parsedown.php trong đó. Bạn giải nén ra và chép vào thư mục của dự án của bạn.
Tiếp theo, bạn chèn tệp tin đó vào nơi bạn cần nó xử lý bằng đoạn mã sau:
include_once '/thư-mục-truy-cập-đến-thư-viện/Pasredown.php';
Vậy là ta đã xong bước cài đặt.
Usage
Rất đơn giản chỉ cần vài dòng mã nữa là xong, mở tập tin mà bạn cần nó xử lý, chèn thư viện vào như bên trên, sau đó ta tiến hành gọi đối tượng nó ra:
$Parsedown = new Parsedown();
Và bây giờ là bỏ đoạn text vào phương thức text
thôi:
echo $Parsedown->text('Xin chào _Parsedown_!'); # Sẽ in ra: <p>Xin chào <em>Parsedown</em>!</p>
Conclusion
Như vậy mình đã giới thiệu cho các bạn về một thư viện hữu ích giúp dịch Markdown cho PHP, hi vọng nó sẽ giúp được bạn trong các dự án sắp tới.
More infomation
Offical Website: http://parsedown.org/
Github: https://github.com/erusev/parsedown/
Who use: phpDocumentor, October CMS, Bolt CMS, Kirby CMS, Grav CMS, Statamic CMS, RaspberryPi.org…
Source: http://blog.dinhquochan.com/php/better-markdown-parse-in-php.html