Tạo tập tin trợ giúp cho vim


8

Hiện tại tôi viết tài liệu của tôi trực tiếp dưới dạng tập tin trợ giúp vim. Đôi khi tôi cần tạo các định dạng khác (ví dụ PDF). Luồng công việc của tôi là sao chép nội dung của các tệp trợ giúp và chuyển đổi chúng thành thứ tôi cần. Đây là một công việc khá tẻ nhạt, vì tôi chủ yếu phải thêm đánh dấu bổ sung.

Tôi thích cách tiếp cận của Markdown, có thể (ví dụ sử dụng Pandoc) được chuyển đổi thành nhiều định dạng đầu ra. Thật không may, tập tin trợ giúp vim. Tôi đang tìm kiếm một trình chuyển đổi có định dạng đầu vào tiêu chuẩn (ví dụ: XML, Markdown, Văn bản được cấu trúc lại, văn bản thuần túy, Thay đổi) xuất ra tệp trợ giúp vim. Hoặc có bất kỳ phương tiện nào khác để tự động tạo tập tin trợ giúp vim mà không cần tự viết trình chuyển đổi như vậy không?


Bạn có thể có thể kết hợp một biểu định kiểu XSLT trong một vài giờ.
Ignacio Vazquez-Abrams

Câu trả lời:


11

Xin lỗi vì đã hồi sinh một chủ đề rất cũ. Tôi là tác giả của mkd2vimdockịch bản đằng sau liên kết đầu tiên được đề xuất bởi lornix trước đó. Gần đây tôi đã viết lại mkd2vimdoctừ đầu lên dưới dạng html2vimdoc . Nó vẫn hỗ trợ Markdown như định dạng đầu vào; nó sẽ chuyển đổi Markdown thành HTML và sau đó chuyển đổi HTML đó thành tệp trợ giúp Vim. Trọng tâm trong quá trình viết lại là hỗ trợ cho một loạt các tài liệu đầu vào.

Kịch bản mới đang được sử dụng bởi bản thân tôi và một số tác giả trình cắm thêm khác, vì vậy nó chắc chắn được dành cho sử dụng chung. Nếu bạn muốn thử lại lần nữa, tôi rất muốn nghe nếu bây giờ nó hoạt động tốt hơn cho các tài liệu bạn muốn sử dụng. Nếu nó vẫn không hoạt động, vui lòng tạo sự cố trên GitHub.


3
Chào mừng bạn đến với SuperUser! Trả lời các câu hỏi cũ được đánh giá cao ở đây, một số người vẫn có thể đang tìm kiếm câu trả lời cho những câu hỏi đó và thật tốt để cải thiện những câu hỏi cũ.
gronostaj

4

Tôi tìm thấy tập lệnh này , mà tác giả đã tạo để chuyển đổi markdown thành tài liệu vim. Âm thanh rất gần với những gì bạn đang tìm kiếm.

Trong khi tập lệnh vim.org này ( github repo ) chuyển đổi đánh dấu thành những gì trông giống như hầu hết mọi thứ NHƯNG vimdoc. (thở dài) Rất gần ... có thể là một sửa đổi nhỏ?


Kịch bản đầu tiên không sử dụng được cho sử dụng chung. Nó có thể hoạt động theo kiểu đánh dấu tác giả, nhưng nó không chuyển đổi một trong các tệp đánh dấu (hợp lệ) của tôi một cách chính xác. Tùy chọn thứ hai là pandoc, một công cụ chuyển đổi rất có khả năng tôi rất thích. Thật không may, nó không hỗ trợ vimhelp. Tôi đã hỏi trong danh sách gửi thư để thêm hỗ trợ cho nó, nhưng câu trả lời là vimhelp không phải là định dạng đầu ra cho mục đích chung mà là định dạng chuyên dùng cho tài liệu vim, trái ngược với các định dạng được hỗ trợ khác. Dù sao, cảm ơn rất nhiều cho tiền boa.
Marco

Tôi tò mò về những gì nó có thể đòi hỏi để tạo một trình chuyển đổi từ markdown sang vimdoc, vì hầu hết các vimdoc là định dạng và các ký tự đánh dấu đặc biệt, trong khi phép thuật được thực hiện bởi lệnh helptags và vim giúp chính người xem. Tất nhiên, tôi CÓ THỂ đặt chân vào miệng (một lần nữa!) ... có lẽ điều đó phụ thuộc vào sự phức tạp của việc đánh dấu ban đầu của bạn.
lornix

Một cách giải quyết thông minh được đề xuất trong danh sách gửi thư là tạo vimhelp cũng là đánh dấu hợp lệ. Hạn chế là việc đánh dấu hơi lộn xộn với cú pháp vim và các tệp vimhelp không tuân theo các quy ước định dạng. Nhưng ngoài ra nó có thể sử dụng được.
Marco
Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.