3

Các thông báo chi tiết một vài điều: hỗ trợ dệt sẽ biến mất, Markdown sẽ chỉ được thực hiện thông qua Kramdown, và Pygments đang biến mất và được thay thế bằng tương thích (và nhanh hơn) Rouge nổi bật cú pháp.

Một số thay đổi có ngày như "Bắt đầu từ ngày 1 tháng 5 năm 2016, Trang GitHub sẽ không còn hỗ trợ Dệt may". Một số điều không có ngày được nêu và tích cực hơn: Mặc dù bắt đầu ngay lập tức, Pygments không được hỗ trợ. Nếu bạn sử dụng Trang Github, lần đẩy tiếp theo của bạn sẽ không triển khai các trang sử dụng Pygments. Mục nhập blog không nói rõ rằng hiện tại Rouge không được hỗ trợ trong Dệt may, vì vậy việc chuyển đổi các phần Pygments thành Rouge nhưng ở lại trong Dệt sẽ không để lại cho bạn các trang được đánh bóng. Các phần Rouge sẽ không được xử lý trong trang HTML cuối cùng. Một lần nữa, đó là mất tích từ thông báo.

Do đó, người dùng GHP với các bài viết trong Dệt may có các đoạn mã Pygments được tô sáng, cần phải truy cập Markdown ngay bây giờ , không phải vào ngày 1 tháng 5. Bạn phát hiện ra khi bạn nhận được email lỗi từ GH và bạn buộc phải rời khỏi bundle updateJekyll ngay lập tức để xem đầu ra lỗi mở rộng mà GH không gửi email cho bạn. Có thể trước khi bạn cập nhật Jekyll cục bộ, hãy tạo một bản dựng cục bộ sao chép thư mục _site vào một nơi an toàn để so sánh sau này.

Pandoc để chuyển đổi hàng dệt may sang Markdown

Theo như tôi có thể giải quyết, việc chuyển đổi Dệt may thành Markdown bằng Pandoc là không hoàn hảo, điều quan trọng nhất là nó không mong đợi các phần quan trọng nhất. Ngoài ra, thẻ Liquid / Jekyll / Rouge không phải là thứ mà nó đang mong đợi xử lý (hoặc bảo tồn).

Viết chuyển đổi riêng của tôi

Đó là Python3 trở lên trên Github . Hãy sử dụng nó. Nó không làm bảng (tôi đã làm năm cái bằng tay). Nó mangles liên kết trong một số trường hợp. Nó không làm gì với những thay đổi kiểu nội tuyến của dệt, ví dụ bạn có thể tạo một từ màu đỏ trong một đoạn văn. Bạn có thể sử dụng các thẻ dệt khác nhau để tập hợp con ... Tôi đã làm.

Để chuyển đổi tất cả các bài viết dệt may của bạn:

find . -name "*.textile" -exec python3 ../conv.py {} \;

Kịch bản này sẽ sao chép các bài viết .textile của bạn trong .md. Nó không thực hiện các hoạt động Git. Thật thú vị, Git nghĩ rằng mọi thứ là một sự đổi tên (thay vì thêm và xóa) nếu nội dung giống nhau 50%. Các bài viết được chuyển đổi từng cái một dường như không gây nhầm lẫn cho Git. Làm cả một tập hợp, và Git bắt đầu không tin có một cuộc đổi tên hàng loạt đang diễn ra.

Những điều khác thiếu từ bài viết Blog GH

Lời khuyên này sẽ rất hay cho _config.yml:

Nếu thiết kế permalink của bạn là như vậy:

permalink: /:year/:month/:day/:title

Bạn nên thay đổi nó thành:

permalink: /:year/:month/:day/:title/

Dấu gạch chéo đó sẽ ngăn bạn trong khi nhận được hậu tố .html bất ngờ cho bài viết của bạn.

Cũng như các thay đổi khác, tài liệu Jekyll3 là một nguồn tốt hơn cho những điều bạn sẽ muốn biết trong quá trình di chuyển này.

Và, tin tốt

Thể loại (và Thẻ) đã trở lại trường hợp hỗn hợp. Thể loại hàng đầu của tôi Trunk Dựa trên Phát triển ban đầu được đặt ra như thế. Sau đó, đã có một sự thay đổi đơn phương để giảm trường hợp “thân cây phát triển dựa.”  Bugs được nâng lên và tranh luận. Bây giờ, chúng tôi trở lại trường hợp ban đầu, mặc dù tôi không biết khi nào điều đó xảy ra, nhưng tôi hài lòng.

|