kramdown

kramdown là một thư viện Ruby miễn phí có thể được sử dụng để phân tích một superset của Markdown & nbsp;. Nó hoàn toàn được viết bằng Ruby, hỗ trợ Markdown chuẩn (với một số thay đổi nhỏ) và phần mở rộng khác nhau đã được thực hiện phổ biến bởi các Markdown PHP gói bổ sung và Maruku.
Nó có lẽ là tinh khiết-Ruby Markdown chuyển đổi nhanh nhất (tháng 11 năm 2009), là 5x nhanh hơn Maruku và khoảng 10x nhanh hơn BlueFeather.
Cú pháp kramdown dựa trên Markdown, rất dễ viết, dễ đọc đánh dấu để viết các tài liệu HTML trong văn bản gốc. Kể từ khi các cú pháp cơ bản Markdown có một số thiếu sót, triển khai (đặc biệt là các PHP Markdown gói Extra) đã cố gắng khắc phục những thiếu sót này với cú pháp bổ sung. kramdown hỗ trợ tất cả các tính năng của cú pháp Markdown gốc (dù với một số chỉnh sửa nhỏ) cũng như các tính năng mới hơn thực hiện trong PHP Markdown gói Extra và Maruku.
Cách sử dụng:
Các gói kramdown cung cấp hai cách để sử dụng nó:
* Là một thư viện
& Nbsp; kramdown sử dụng về cơ bản giống như các API RedCloth, BlueCloth và Maruku:
& Nbsp; đòi hỏi 'kramdown'
& Nbsp; Kramdown :: Document.new (text) .to_html
& Nbsp; Tham số thứ hai để các cuộc gọi mới là một lựa chọn cho các hash (de) kích hoạt tính năng nhất định. Để biết thêm thông tin có một cái nhìn tại các tài liệu API.
* Là một ứng dụng
& Nbsp; Cùng với thư viện các tập tin nhị phân được gọi là kramdown được vận chuyển mà có thể được sử dụng để chuyển đổi văn bản trong cú pháp kramdown sang HTML. Nó hoặc đọc từ các tập tin được chỉ định như các đối số dòng lệnh hoặc từ đầu vào chuẩn. Ví dụ như:
& Nbsp; đường dẫn kramdown / to / kramdown / doc / syntax.page

là gì mới trong phiên bản này:

• 2 nhỏ thay đổi:
• Thêm một phân tích cú pháp cho Github Flavored Markdown (giải quyết GH # 68 bởi Arne Brasseur đã cung cấp thực hiện ban đầu)
• thuộc tính HTML hiện đang đầu ra cho dòng ngang

Sửa
• 5 lỗi:
• Các mã đúng vào chuỗi kết quả là bây giờ thiết lập ngay cả khi lựa chọn mẫu được sử dụng
• Cố định GH # 72, # 74 GH: Tất cả cách để thiết lập một ID tiêu đề bây giờ làm theo các chương trình tương tự đó là phù hợp với các ID HTML (ngoại trừ dấu chấm không được phép) (báo cáo và bản vá đầu bởi Matti Schneider)
• Cố định GH # 73: Các mẫu HTML mặc định bây giờ có một DOCTYPE và thiết lập mã hóa một cách chính xác (patch ban đầu của Simon Lydell)
• Cố định GH # 67: URL của các yếu tố liên kết hiện đang trốn trong bộ chuyển đổi LaTeX để tránh các vấn đề (bản vá của Henning Perl)
• Cố định GH # 70: Bất kỳ phiên bản của thư viện stringex được hỗ trợ (do Simon Lydell)

là gì mới trong phiên bản 1.1.0:

• 2 thay đổi nhỏ:

Dấu
• Footnote bây giờ có thể được lặp đi lặp lại (giải quyết GH # 62 và # 63 GH bởi Theodore Pak đã cung cấp các bản vá ban đầu)
• Các gói từ viết tắt LaTeX hiện được sử dụng cho các chữ viết tắt (giải quyết GH # 55 bởi Tim Besard người cung cấp các bản vá ban đầu)

Sửa
• 3 lỗi:
• Cố định GH # 60: Những con số đã được công nhận ở ngoài nhân vật từ khi chuyển đổi dấu gạch dưới (patch bởi Trevor Wennblom)
• Cố định GH # 66: yếu tố HTML, và đang chuyển đổi một cách chính xác bởi bộ chuyển đổi LaTeX (patch bởi Henning Perl)
• Cố định GH # 57: Better xử lý quote thông minh khi gạch chân là trực tiếp sau hoặc trước dấu ngoặc kép (do Bill Tozier)

mới trong phiên bản 1.0.2 là gì:

• Các trang thử nghiệm đã được cập nhật để bao gồm thời gian tương đối trong các điểm chuẩn để có thể đánh giá tốt hơn hiệu suất của kramdown (theo yêu cầu của hậu hiện đại).
• Các kramdown Wiki bây giờ chứa một danh sách các thư viện mở rộng kramdown (ý tưởng của hậu hiện đại).

là gì mới trong phiên bản 1.0.0:

• 4 thay đổi nhỏ:
• transliterated_header_ids Lựa chọn mới cho transliterating văn bản tiêu đề thành ASCII trước khi tạo ra một ID tiêu đề đó là hữu ích cho các ngôn ngữ như tiếng Việt (cố định GH # 35, theo yêu cầu của Kỳ Anh)
• Các dấu ngoặc kép thực thể & quot; nay được chuyển đổi để tương đương với nhân vật của mình khi entity_output = as_char.
• Một cảnh báo hiện nay là đầu ra cho ials / ALDs có chứa thuộc tính không defintion.
• đầu ra HTML ghi chú được thay đổi để sử dụng lớp thay vì rel để đạt được (X) HTML4 / 5 tương thích

Sửa
• 3 lỗi:
• Cố định GH # 38: Mã hóa vấn đề trên 1.9 / 2.0 do mã hóa không tương thích - chuỗi nguồn bây giờ được chuyển đổi sang UTF-8 trước khi phân tích và chuyển đổi trở lại sau khi chuyển đổi (do Simon Lydell)
• Cố định RF # 29647: viết tắt với không từ ký tự đầu tiên khi khởi chì văn bản đến ngoại lệ (báo cáo của Stephan Dale)
• Cố định RF # 29704: ID quy định về tiêu đề kiểu ATX luôn không được phát hiện một cách chính xác (báo cáo của Kyle Barbour)

là gì mới trong phiên bản 0.14.2:

• 1 thay đổi nhỏ:
• New link_defs lựa chọn cho các định nghĩa liên kết xác định trước

Sửa chữa
• 1 lỗi:
• Cố định lỗi nêu trên tiêu đề ATX không có văn bản

là gì mới trong phiên bản 0.14.1:

• Chỉ có các phần tử HTML mà không cần phải có một cơ thể ( như) là đầu ra ở dạng này, tất cả các yếu tố khác bây giờ sử dụng một thẻ đóng rõ ràng (giải quyết các vấn đề khác với điều)
• Xác định một khối IAL trước một danh sách định nghĩa hiện đang làm việc một cách chính xác
• Sửa lỗi GH # 30: Hết cơ thể cho một định nghĩa trong một danh sách định nghĩa dẫn đến một ngoại lệ (do Mark Johnson)

là gì mới trong phiên bản 0.14.0:

• 2 thay đổi lớn:
• Mã ngôn ngữ hiện nay được xác định thông qua .language-CODELANG thay vì lang = 'CODELANG'
• Thực hiện hỗ trợ cho việc thiết lập ngôn ngữ trên mã rào dòng khối khởi đầu (patch ban đầu của Bran)
• 1 thay đổi nhỏ:
• Headers với một ID có thể được ngăn chặn hiển thị trong mục lục bằng cách gán các lớp .no_toc cho họ (patch bởi Tim Bates)

Sửa chữa
• 1 lỗi:
• Numeric thay vì thực thể HTML biểu tượng hiện tại là dự phòng mặc định (bản vá của Gioele Barabucci)

là gì mới trong phiên bản 0.13.5:

• 2 thay đổi nhỏ:
• HTML thuộc tính mà không có giá trị đang được hỗ trợ (sửa lỗi RF # 29.490 báo cáo của Nat Welch)
• HTML thuộc tính tên đang luôn luôn chuyển đổi để giảm trường hợp cho quán

Sửa
• 5 lỗi:
• Cố định Document # method_missing để chấp nhận tên lớp snake_cased (patch bởi tomykaira)
• Cố định vấn đề với thiếu REXML liên tục trên các phiên bản cũ hơn của Ruby 1.8.6 (báo cáo của Dave Everitt)
• Sửa lỗi RF # 29520: inline Valid cáo toán học không kích hoạt khối toán nữa (báo cáo của Gioele Barabucci)
• Sửa lỗi RF # 29521: sản lượng toán HTML nay luôn XHTML tương thích (báo cáo của Gioele Barabucci)
• thuộc tính id Hết giờ được xử lý tốt hơn bằng HTML và kramdown chuyển đổi (do Jorg Sommer)

Sửa chữa
• 1 tài liệu:
• Cố định tùy chọn không hợp lệ tuyên bố trong ví dụ trên trang tham khảo nhanh (báo cáo của Jorg Sommer)

là gì mới trong phiên bản 0.13.4:

• Thêm một công cụ chuyển đổi dùng để chiết xuất các TOC của một tài liệu (theo yêu cầu của Brendan Hay). Lưu ý rằng đây chỉ là hữu ích nếu bạn sử dụng kramdown như một thư viện!
• Cố định một lỗi đánh máy: Cần --output và không --ouput (patch của hậu hiện đại)
• Sửa đổi HTML để chính xác sản lượng thẻ khoảng trống (patch bởi John Croisant)
• Sửa lỗi RF # 29350: Phân tích cú pháp của các thẻ HTML với trường hợp không phù hợp với doanh nghiệp hoạt động
• Sửa lỗi RF # 29426: Nội dung của thẻ phong cách được coi là văn bản thô tại
• Chuyển đổi HTML hiện đang sử dụng rel thay vì rev là tương thích HTML5 (patch bởi Joe Fiorini)
• cố định của Ruby 1.9.3 cảnh báo liên quan
• Sửa lỗi phân tích cú pháp HTML để làm việc xung quanh một sự thay đổi thực hiện của Array # delete_if trong Ruby 1.9.3

Yêu cầu :

• Ruby