Như chúng tôi vừa đề cập trước đây, Markdown ban đầu được thiết kế cho đầu ra HTML, vì vậy có thể không ngạc nhiên khi định dạng HTML có nhiều tính năng phong phú nhất trong số tất cả các định dạng đầu ra. Chúng tôi khuyên bạn nên đọc toàn bộ phần này trước khi tìm hiểu các định dạng đầu ra khác, vì các định dạng khác có một số tính năng chung với định dạng tài liệu HTML và chúng tôi sẽ không lặp lại các tính năng này trong các phần tương ứng
Để tạo một tài liệu HTML từ R Markdown, bạn chỉ định định dạng đầu ra
---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
1 trong siêu dữ liệu YAML của tài liệu của bạn---
title: Habits
author: John Doe
date: March 22, 2005
output: html_document
---
Bạn có thể thêm mục lục [TOC] bằng cách sử dụng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
2 và chỉ định độ sâu của tiêu đề áp dụng cho việc sử dụng tùy chọn ---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
3. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
Nếu độ sâu của mục lục không được chỉ định rõ ràng, nó sẽ mặc định là 3 [có nghĩa là tất cả các tiêu đề cấp 1, 2 và 3 sẽ được đưa vào mục lục]
Bạn có thể chỉ định tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
4 để làm nổi mục lục ở bên trái nội dung tài liệu chính. Mục lục nổi sẽ luôn hiển thị ngay cả khi tài liệu được cuộn. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
Bạn có thể tùy ý chỉ định một danh sách các tùy chọn cho tham số
---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
4 kiểm soát hành vi của nó. Các tùy chọn này bao gồm
6 [mặc định là--- title: "Habits" output: html_document: toc: true toc_float: collapsed: false smooth_scroll: false ---
7] kiểm soát liệu TOC có xuất hiện chỉ với cấp cao nhất hay không [e. g. , H2] tiêu đề. Nếu ban đầu được thu gọn, TOC sẽ tự động được mở rộng nội tuyến khi cần thiết--- title: "Habits" output: html_document: toc: true toc_float: collapsed: false smooth_scroll: false ---
8 [mặc định là--- title: "Habits" output: html_document: toc: true toc_float: collapsed: false smooth_scroll: false ---
7] kiểm soát xem các cuộn trang có hoạt ảnh hay không khi các mục TOC được điều hướng đến thông qua nhấp chuột--- title: "Habits" output: html_document: toc: true toc_float: collapsed: false smooth_scroll: false ---
Ví dụ
---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
Bạn có thể thêm phần đánh số vào tiêu đề bằng cách sử dụng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
0---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
Lưu ý rằng nếu bạn chọn sử dụng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
0, bạn cũng có thể muốn sử dụng tiêu đề ---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
2 [H1] trong tài liệu của mình vì tiêu đề ---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
3 [H2] sẽ bao gồm dấu thập phân, bởi vì không có tiêu đề H1, tiêu đề H2 của bạn sẽ được đánh số Bạn có thể sắp xếp nội dung bằng cách sử dụng các tab bằng cách áp dụng thuộc tính lớp
---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
6 cho các tiêu đề trong tài liệu. Điều này sẽ khiến tất cả các tiêu đề phụ của tiêu đề có thuộc tính ---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
6 xuất hiện trong các tab thay vì dưới dạng các phần độc lập. Ví dụ## Quarterly Results {.tabset}
### By Product
[tab content]
### By Region
[tab content]
Bạn cũng có thể chỉ định hai thuộc tính bổ sung để kiểm soát giao diện và hành vi của các tab. Thuộc tính
---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
8 làm cho các tab mờ dần trong và ngoài khi chuyển đổi giữa các tab. Thuộc tính ---
title: "Habits"
output:
html_document:
toc: true
number_sections: true
---
9 làm cho giao diện trực quan của các tab giống như “viên thuốc” [xem Hình ] thay vì các tab truyền thống. Ví dụ## Quarterly Results {.tabset .tabset-fade .tabset-pills}
HÌNH 3. 1. Tab truyền thống và tab viên thuốc trên trang HTML
Có một số tùy chọn kiểm soát sự xuất hiện của tài liệu HTML
0 chỉ định chủ đề Bootstrap sẽ sử dụng cho trang [các chủ đề được lấy từ thư viện chủ đề Bootswatch]. Các chủ đề hợp lệ bao gồm mặc định, bootstrap, cerulean, cosmo, darkly, flatly, journal, lumen, paper, readable, sa thạch, simplex, spacelab, united và yeti. Vượt qua## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
1 nếu không có chủ đề [trong trường hợp này, bạn có thể sử dụng tham số## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
2 để thêm phong cách của riêng mình]## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
3 chỉ định kiểu đánh dấu cú pháp. Các phong cách được hỗ trợ bao gồm## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
4,## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
5,## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
6,## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
7,## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
8,## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
9,## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
0,## Quarterly Results {.tabset .tabset-fade .tabset-pills}
1,## Quarterly Results {.tabset .tabset-fade .tabset-pills}
2 và## Quarterly Results {.tabset .tabset-fade .tabset-pills}
3. Vượt qua## Quarterly Results {.tabset .tabset-fade .tabset-pills}
1 để ngăn đánh dấu cú pháp## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
5 cho biết liệu có tạo đầu ra chính xác về mặt đánh máy hay không, chuyển đổi dấu ngoặc kép thẳng thành dấu ngoặc kép,## Quarterly Results {.tabset .tabset-fade .tabset-pills}
6 thành dấu gạch ngang,## Quarterly Results {.tabset .tabset-fade .tabset-pills}
7 thành dấu gạch ngang và## Quarterly Results {.tabset .tabset-fade .tabset-pills}
8 thành dấu chấm lửng. Lưu ý rằng## Quarterly Results {.tabset .tabset-fade .tabset-pills}
5 được bật theo mặc định## Quarterly Results {.tabset .tabset-fade .tabset-pills}
Ví dụ
---
title: "Habits"
output:
html_document:
theme: united
highlight: tango
---
Bạn có thể thêm CSS của riêng mình vào tài liệu HTML bằng tùy chọn
## Quarterly Results {.tabset}
### By Product
[tab content]
### By Region
[tab content]
2---
title: "Habits"
output:
html_document:
css: styles.css
---
Nếu bạn muốn cung cấp tất cả các kiểu cho tài liệu từ CSS của riêng mình, bạn đặt
## Quarterly Results {.tabset}
### By Product
[tab content]
### By Region
[tab content]
0 [và có khả năng là ## Quarterly Results {.tabset}
### By Product
[tab content]
### By Region
[tab content]
3] thành ## Quarterly Results {.tabset}
### By Product
[tab content]
### By Region
[tab content]
1---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
Bạn cũng có thể nhắm mục tiêu các phần tài liệu cụ thể bằng CSS tùy chỉnh bằng cách thêm id hoặc lớp vào tiêu đề phần trong tài liệu của mình. Ví dụ: tiêu đề phần sau
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
0Sẽ cho phép bạn áp dụng CSS cho tất cả nội dung của nó bằng cách sử dụng một trong các bộ chọn CSS sau
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
1Có một số tùy chọn ảnh hưởng đến việc xuất số liệu trong tài liệu HTML
Có thể sử dụng
4 và--- title: "Habits" output: html_document: theme: united highlight: tango ---
5 để kiểm soát chiều rộng và chiều cao của hình mặc định [7x5 được sử dụng theo mặc định]--- title: "Habits" output: html_document: theme: united highlight: tango ---
6 chỉ định tỷ lệ để thực hiện cho màn hình retina [mặc định là 2, hiện đang hoạt động cho tất cả màn hình retina được sử dụng rộng rãi]. Đặt thành--- title: "Habits" output: html_document: theme: united highlight: tango ---
1 để ngăn võng mạc co giãn## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
8 kiểm soát xem các số liệu có được hiển thị kèm theo chú thích hay không--- title: "Habits" output: html_document: theme: united highlight: tango ---
9 điều khiển thiết bị đồ họa được sử dụng để hiển thị số liệu [mặc định là--- title: "Habits" output: html_document: theme: united highlight: tango ---
0]--- title: "Habits" output: html_document: css: styles.css ---
Ví dụ
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
2Bạn có thể nâng cao hiển thị mặc định của khung dữ liệu thông qua tùy chọn
---
title: "Habits"
output:
html_document:
css: styles.css
---
1. Các giá trị hợp lệ được hiển thị trong BảngBÀN SỐ 3. 1. Các giá trị có thể có của tùy chọn ---
title: "Habits"
output:
html_document:
css: styles.css
---
1 cho định dạng ---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
1. mặc địnhGọi phương thức chung ---
title: "Habits"
output:
html_document:
css: styles.css
---
4kableSử dụng hàm ---
title: "Habits"
output:
html_document:
css: styles.css
---
5tibbleSử dụng hàm ---
title: "Habits"
output:
html_document:
css: styles.css
---
6pagedSử dụng ---
title: "Habits"
output:
html_document:
css: styles.css
---
7 để tạo bảng có thể phân trangMột hàm tùy chỉnhSử dụng hàm để tạo bảngKhi tùy chọn
---
title: "Habits"
output:
html_document:
css: styles.css
---
1 được đặt thành ---
title: "Habits"
output:
html_document:
css: styles.css
---
9, bảng được in dưới dạng bảng HTML có hỗ trợ phân trang theo hàng và cột. Ví dụ [xem Hình ]---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
3HÌNH 3. 2. Bảng được phân trang trong tài liệu đầu ra HTML
Bảng hiển thị các tùy chọn có sẵn cho bảng được phân trang
BÀN SỐ 3. 2. Các tùy chọn cho bảng HTML được phân trang. tối đa. print Số dòng cần in. hàng. print Số dòng hiển thị. cols. print Số cột cần hiển thị. cols. tối thiểu. print Số lượng cột tối thiểu để hiển thị. trang. in Số lượng trang sẽ hiển thị dưới điều hướng trang. phân trang. printKhi được đặt thành---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
0 sẽ tắt bảng phân trang. tên gọi. printKhi được đặt thành ---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
0 sẽ tắt tên hàngCác tùy chọn này được chỉ định trong từng đoạn như bên dưới
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
4Tùy chọn
---
title: "Habits"
output:
html_document:
css: styles.css
---
1 cũng có thể nhận một chức năng tùy ý để tạo bảng trong tài liệu đầu ra. Chức năng này phải xuất ra đúng định dạng theo đầu ra được sử dụngVí dụ,
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
5tương đương với việc sử dụng phương pháp
---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
3---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
6Để sử dụng chức năng tùy chỉnh trong
---
title: "Habits"
output:
html_document:
css: styles.css
---
1 trong tiêu đề YAML, thẻ ---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
5 phải được sử dụng để biểu thức R sau nó sẽ được đánh giá. Xem đối số ---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
6 trên trang trợ giúp ---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
7 để biết chi tiết---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
7Khi tùy chọn knitr chunk
---
title: "Habits"
output:
html_document:
theme: null
highlight: null
css: styles.css
---
8 được chỉ định [hành vi mặc định], mã nguồn R trong chunk được bao gồm trong tài liệu được kết xuất. Trong một số trường hợp, có thể thích hợp để loại trừ hoàn toàn mã [_______52_______9] nhưng trong các trường hợp khác, bạn có thể muốn mã có sẵn nhưng không hiển thị theo mặc địnhTùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
00 cho phép bạn bao gồm mã R nhưng ẩn mã này theo mặc định. Sau đó, người dùng có thể chọn hiển thị các đoạn mã R ẩn riêng lẻ hoặc toàn bộ tài liệu. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
8Bạn có thể chỉ định
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
01 để vẫn hiển thị tất cả mã R theo mặc định nhưng sau đó cho phép người dùng ẩn mã nếu họ muốnTheo mặc định, các tập lệnh MathJax được bao gồm trong tài liệu HTML để hiển thị các phương trình LaTeX và MathML. Bạn có thể sử dụng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
02 để kiểm soát cách đưa MathJax vàoChỉ định
03 để sử dụng URL HTTPS từ máy chủ CDN [hiện do RStudio cung cấp]--- title: "Habits" output: html_document: toc: true toc_depth: 2 ---
Chỉ định
04 để sử dụng phiên bản MathJax cục bộ [được sao chép vào thư mục đầu ra]. Lưu ý rằng khi sử dụng--- title: "Habits" output: html_document: toc: true toc_depth: 2 ---
04, bạn cũng cần đặt tùy chọn--- title: "Habits" output: html_document: toc: true toc_depth: 2 ---
06 thành--- title: "Habits" output: html_document: toc: true toc_depth: 2 ---
07--- title: "Habits" output: html_document: toc: true toc_depth: 2 ---
Chỉ định một URL thay thế để tải MathJax từ một vị trí khác
Chỉ định
1 để loại trừ hoàn toàn MathJax## Quarterly Results {.tabset} ### By Product [tab content] ### By Region [tab content]
Ví dụ: để sử dụng bản sao cục bộ của MathJax
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
9Để sử dụng bản sao MathJax tự lưu trữ
---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
0Để loại trừ hoàn toàn MathJax
---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
1Theo mặc định, R Markdown tạo các tệp HTML độc lập không có phụ thuộc bên ngoài, sử dụng URI
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
09 để kết hợp nội dung của các tập lệnh, biểu định kiểu, hình ảnh và video được liên kết. Điều này có nghĩa là bạn có thể chia sẻ hoặc xuất bản tệp giống như bạn chia sẻ tài liệu Office hoặc tệp PDF. Nếu bạn muốn giữ các phần phụ thuộc trong các tệp bên ngoài, bạn có thể chỉ định ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
10. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
2Lưu ý rằng ngay cả đối với các tài liệu độc lập, MathJax vẫn được tải từ bên ngoài [điều này là cần thiết vì kích thước lớn của nó]. Nếu bạn muốn phục vụ MathJax tại địa phương, bạn nên chỉ định
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
11 và ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
10Một lý do phổ biến để giữ các phần phụ thuộc bên ngoài là để phục vụ các tài liệu R Markdown từ một trang web [các phần phụ thuộc bên ngoài có thể được trình duyệt lưu vào bộ đệm riêng, dẫn đến thời gian tải trang nhanh hơn]. Trong trường hợp phục vụ nhiều tài liệu R Markdown, bạn cũng có thể muốn hợp nhất các tệp thư viện phụ thuộc [e. g. Bootstrap và MathJax, v.v. ] vào một thư mục được chia sẻ bởi nhiều tài liệu. Bạn có thể sử dụng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
13 để thực hiện việc này. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
3Khi knitr xử lý tệp đầu vào R Markdown, nó sẽ tạo tệp Markdown [
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
14] sau đó được Pandoc chuyển đổi thành HTML. Nếu bạn muốn giữ một bản sao của tệp Markdown sau khi kết xuất, bạn có thể làm như vậy bằng cách sử dụng tùy chọn ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
15---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
4Bạn có thể thực hiện tùy chỉnh đầu ra nâng cao hơn bằng cách bao gồm nội dung HTML bổ sung hoặc bằng cách thay thế hoàn toàn mẫu Pandoc cốt lõi. Để đưa nội dung vào tiêu đề tài liệu hoặc trước/sau nội dung tài liệu, bạn sử dụng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
16 như sau---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
5Bạn cũng có thể thay thế mẫu Pandoc bên dưới bằng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
17---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
6Tham khảo tài liệu trên để biết thêm chi tiết về các mẫu. Bạn cũng có thể nghiên cứu mẫu HTML mặc định
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
18 làm ví dụTheo mặc định, R Markdown được định nghĩa là tất cả các tiện ích mở rộng Pandoc Markdown với các điều chỉnh sau để tương thích ngược với gói markdown cũ []
---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
7Bạn có thể bật hoặc tắt tiện ích mở rộng Markdown bằng tùy chọn
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
19 [bạn mở đầu một tùy chọn bằng ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
20 để tắt và ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
21 để bật tùy chọn đó]. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
8Điều trên sẽ vô hiệu hóa tiện ích mở rộng
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
22 và bật tiện ích mở rộng ---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
23Để biết thêm về các tiện ích mở rộng đánh dấu có sẵn, hãy xem
Nếu có các tính năng của Pandoc mà bạn muốn sử dụng nhưng thiếu các tính năng tương đương trong các tùy chọn YAML được mô tả ở trên, bạn vẫn có thể sử dụng chúng bằng cách chuyển
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
24 tùy chỉnh. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_float: true
---
9Tài liệu về tất cả các đối số pandoc có sẵn có thể được tìm thấy trong
Nếu bạn muốn tạo một đoạn HTML thay vì một tài liệu HTML đầy đủ, bạn có thể sử dụng định dạng
---
title: "Habits"
output:
html_document:
toc: true
toc_depth: 2
---
25. Ví dụ---
title: "Habits"
output:
html_document:
toc: true
toc_float:
collapsed: false
smooth_scroll: false
---
0Lưu ý rằng các đoạn HTML không phải là tài liệu HTML hoàn chỉnh. Chúng không chứa nội dung tiêu đề tiêu chuẩn mà tài liệu HTML có [chúng chỉ chứa nội dung trong các thẻ của tài liệu HTML thông thường]. Chúng được dùng để đưa vào các trang web hoặc hệ thống quản lý nội dung khác [như blog]. Do đó, chúng không hỗ trợ các tính năng như chủ đề hoặc đánh dấu mã [người ta cho rằng môi trường mà chúng được xuất bản cuối cùng sẽ xử lý những thứ này]