Trong khi chuyển đổi Markdown sang HTML bằng Pandoc, bạn có thể sử dụng biểu định kiểu CSS bên ngoài bằng tùy chọn -c
pandoc -s README.md -c custom.css -o README.html
Lệnh giả định rằng bạn đã có sẵn CSS tùy chỉnh. Nếu không, một khả năng là sử dụng biểu định kiểu CSS không có lớp. Tôi tình cờ gặp MVP. css gần đây và thích giao diện của nó
Sử dụng MVP. css
Để sử dụng MVP. css để ghi lại dự án mà tôi đang thực hiện, tôi phải thực hiện một số thay đổi đối với mẫu HTML mặc định của Pandoc. Đây là những bước tôi đã làm theo
Lấy mẫu HTML mặc định
Đầu tiên, tôi đã lưu mẫu mặc định vào một tệp
pandoc -D html > template.html
Sửa đổi mẫu HTML
Sau đó, tôi đã thực hiện những thay đổi này trong template.html
- Di chuyển TOC đến menu thả xuống trong điều hướng trang web
- Thêm một nút có liên kết đến trang web của dự án
- Cập nhật bảng màu bằng cách sử dụng các biến CSS và thực hiện một số điều chỉnh nhỏ đối với kiểu
Sử dụng mẫu đã sửa đổi
Sau khi thêm một số siêu dữ liệu YAML vào README.md
, tôi đã chạy lại pandoc
với mẫu và tệp CSS đã sửa đổi để tạo đầu ra cuối cùng
Với R Markdown, bạn viết một. Rmd và sau đó sử dụng nó để hiển thị đầu ra đã hoàn thành ở nhiều định dạng khác nhau
Tài liệu HTML để xuất bản web
Sử dụng R Markdown cùng với bookdown để tạo sách và sau đó phân phối sách dưới dạng tài liệu PDF, HTML, EPUB, v.v. Dưới đây là một số cuốn sách đã được tác giả trong R Markdown
markdownToHTML
chuyển đổi văn bản đánh dấu do người dùng cung cấp thành biến số file
hoặc text
. Chuyển đổi HTML được ghi vào tệp output
hoặc được trả lại cho người dùng dưới dạng vectơ character
Cách sử dụng
markdownToHTML[file, output = NULL, text = NULL, options = getOption["markdown.HTML.options"], extensions = getOption["markdown.extensions"], title = "", stylesheet = getOption["markdown.HTML.stylesheet"], header = getOption["markdown.HTML.header"], template = getOption["markdown.HTML.template"], fragment.only = FALSE, encoding = getOption["encoding"]]
Tranh luận
file
một chuỗi ký tự cung cấp tên đường dẫn của tệp để đọc từ. Nếu nó bị bỏ qua trong danh sách đối số, thì có thể coi là đối số text
sẽ được sử dụng thay thế
output
một chuỗi ký tự cung cấp tên đường dẫn của tệp để ghi vào. Nếu nó bị bỏ qua [
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]0], thì có thể cho rằng người dùng mong đợi kết quả được trả về dưới dạng vectơ
character
text
một vectơ ký tự chứa văn bản đánh dấu để chuyển đổi [mỗi phần tử của vectơ này được coi là một dòng trong tệp]
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]3
các tùy chọn được chuyển đến trình kết xuất. xem
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]4
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]5
các tùy chọn được chuyển đến công cụ đánh dấu. Xem
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]6
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]7
Tiêu đề HTML
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]8
CSS hợp lệ hoặc tệp chứa CSS. sẽ được đưa vào đầu ra
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]9
HTML hợp lệ hoặc tệp chứa HTML sẽ được đưa vào tiêu đề của đầu ra
markdownToHTML
0một tệp HTML được sử dụng làm mẫu
markdownToHTML
1Có hay không tạo một đoạn HTML mà không có tiêu đề HTML và thẻ nội dung, CSS và các thành phần Javascript
markdownToHTML
2mã hóa của tệp đầu vào;
Thông tin chi tiết
Ba tùy chọn HTML đáng chú ý đã được thêm vào để hỗ trợ nghiên cứu hợp tác tái sản xuất. Chúng như sau
Các biểu thức toán học latex được kèm theo một trong các cú pháp cấp khối, $latex. $ , $$. $$ hoặc \[. \] hoặc một trong các cú pháp nội tuyến, $. $ hoặc \[. \], sẽ được thư viện Javascript MathJax hiển thị trong thời gian thực
Các khối mã R được đặt giữa
markdownToHTML
4 vàmarkdownToHTML
5 sẽ tự động được đánh dấu cú phápMọi hình ảnh cục bộ được liên kết bằng thẻ sẽ được mã hóa base64 và được đưa vào HTML đầu ra.
Xem phần CHI TIẾT bên dưới và
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]4 để biết thêm thông tin
Có hai chế độ cơ bản để markdownToHTML
được xác định bởi giá trị của đối số markdownToHTML
1
Khi markdownToHTML
9, markdownToHTML
tạo các trang HTML độc lập được định dạng tốt hoàn chỉnh với các thẻ tiêu đề, tiêu đề và nội dung HTML. Mẫu mặc định được sử dụng cho chế độ này có thể được tìm thấy tại đây
file
1
Ngoài ra, markdownToHTML
sẽ tự động xác định xem có cần làm nổi bật mã mathjax và mã R hay không và sẽ bao gồm các thư viện Javascript thích hợp trong đầu ra. Do đó, không cần thiết lập rõ ràng các tùy chọn file
3 hoặc file
4 [xem
[markdownToHTML[text = "Hello World!", fragment.only = TRUE]] [markdownToHTML[file = NULL, text = "_text_ will override _file_", fragment.only = TRUE]] # write HTML to an output file markdownToHTML[text = "_Hello_, **World**!", output = "test.html"]4 để biết thêm chi tiết]