Hướng dẫn định dạng hướng dẫn
Phiên bản 1.3Nếu bạn muốn xuất bản hướng dẫn trên HowtoForge, vui lòng đọc hướng dẫn nÃy để tìm hiểu cách định dạng hướng dẫn cá»§a bạn sao cho phù hợp vá»›i giao diện cá»§a HowtoForge và hấp dẫn vá»›i nhiều độc giả nhất có thể. Các hướng dẫn nÃy cÅ©ng giúp bạn giảm thiểu kÃch thước tÃi liệu cá»§a mình.
1 Tôi sá» dụng chương trình nÃo để viết HowTo cá»§a mình?
Sá» dụng trình soạn thảo HTML như Dreamweaver hoặc trình soạn thảo miá»…n phà Bluegriffon http://www.bluegriffon.org/hoặc bất kỳ trình soạn thảo HTML nÃo khác tạo ra HTML hợp lệ. Không sá» dụng MS Word để tạo ná»™i dung HTML vì Word tạo ra HTML "lạ"...2 Tôi bắt đầu như thế nÃo?
Được rồi, bạn Ä‘ang ngồi trước trình soạn thảo HTML, sẵn sÃng bắt đầu, nhưng tiếp theo là gì? Vui lòng sao chép bá»™ khung HTML nÃy vÃo trình soạn thảo cá»§a bạn:
Mã:
|
3 Định dạng
3.1 Văn bản thường
Luôn sỠdụng phông chữ mặc định cho văn bản thường và tiêu đề! Không sỠdụng thẻ <font> và không định nghĩa các lớp CSS của riêng bạn. Tất cả định dạng sẽ được thực hiện bởi các lớp CSS của HowtoForge sau khi bạn đã xuất bản hướng dẫn của mình trên HowtoForge.Và dụ, một cái gì đó như
Mã:
Đây là một câu.
Mã:
Đây là một câu.
Đây là một câu.
3.2 Tiêu đề
Vui lòng sỠdụng <h1>...</h1>, <h2>...</h2>, <h3>...</h3>, <h4>...</h4> hoặc <h5>...</h5> để định dạng tiêu đề. Một lần nữa, không sỠdụng thẻ <font> hoặc lớp CSS để định dạng chúng.Tiêu đề
Mã:
[HEADING=3]Đây là tiêu đề[/HEADING]
Đây là tiêu đề
3.3 Lệnh
Vui lòng sỠdụng lớp CSS .command (được định nghĩa trong phần <head>...</head> trong khung HTML) để định dạng lệnh shell để người đọc biết rằng đó là lệnh họ phải thực thi trên shell. Và dụ,
Mã:
chmod 755 /path/to/file
Mã:
chmod 755 /path/to/file
3.4 Nội dung của tệp
Nội dung của tệp phải được đặt trong <pre>...</pre>. Và dụ, nếu bạn muốn hiển thị cho người đọc nội dung của /etc/resolv.conf, bạn thực hiện như sau:
Mã:
search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.60
Mã:
search servernameserver 145.253.2.75nameserver 193.174.32.18nameserver 194.25.0.60
3.5 Tên tệp, Tên giao thức, Thông số kỹ thuáºt hệ thống, Thông số kỹ thuáºt, v.v.
Nếu bạn Ä‘ang viết về các mục liên quan đến hệ thống Linux mà không phải là lệnh, nhưng bạn vẫn muốn định dạng theo cách đặc biệt, bạn có thể sá» dụng lá»›p CSS .system. Và dụ, nếu bạn đề cáºp đến tên tệp trong văn bản thông thường, bạn nên định dạng như sau:
Mã:
Tiếp theo, chúng ta chỉnh sá»a /etc/network/interfaces để trông như thế nÃy:...
Tiếp theo, chúng ta chỉnh sá»a /etc/network/interfaces để trông như thế nÃy:...
3.6 Tô sáng
Nếu bạn muốn tô sáng má»™t ná»™i dung nÃo đó, bạn có thể sá» dụng lá»›p CSS .highlight. Và dụ,
Mã:
server1:
server1: