Hướng Dẫn Thêm Một Bài Kinh Vào Trang Tam Tạng

Trang này viết cho người soạn bài. Cố ý viết khô và chính xác. Cứ theo đúng đây thì bài kinh mới sẽ hiện ra trong mọi mục lục, các thanh tiến độ nhích lên, và nút “bài trước / bài sau” ở hai bài kế cận tự trỏ tới — mà không phải sửa một dòng HTML nào.

Phần I · Nguyên Tắc

Vì sao không phải sửa thanh điều hướngMột tệp dữ liệu, mười mấy trang tự đọc theo

Toàn bộ những gì anh chị thấy trong các mục lục đều đến từ một tệp duy nhất: js/tamtang-data.js. Bản thân các trang HTML không chứa danh sách bài kinh nào cả — chỉ có một dấu hiệu nói “đặt mục lục Trung Bộ vào chỗ này”. Sửa tệp dữ liệu thì mọi trang đọc nó đổi theo cùng một lúc.

Chính vì vậy mà toàn bộ mục lục đã được viết ra trước, đủ cả 34 bài Trường Bộ, đủ cả 152 bài Trung Bộ và phần còn lại, trước khi có một trang bài kinh nào. Đóng kệ trống trước mới là điều cho phép mỗi ngày thêm một cuốn, làm suốt nhiều năm mà không phải sắp xếp lại lần nào.

✦

Phần II · Ba Bước

Từ tệp trống tới bài kinh lên trangKhoảng mười phút, chưa kể thời gian viết

Bước 1

Chép khuôn mẫu

Trong thư mục kinh/, chép tệp _mau-bai-kinh.html rồi đổi tên thành tên bài mới.

Thí dụ soạn Kinh Niệm Xứ (MN 10) thì đặt tên trungbo-010-niem-xu.html.

Bước 2

Viết nội dung

Mở tệp vừa chép. Mọi chỗ cần điền đều được đánh dấu bằng  và chữ in hoa.

Đừng đụng tới phần đầu tệp và phần cuối tệp — đó là khung chung của cả website.

Bước 3

Ghi một dòng

Mở js/tamtang-data.js, tìm bài kinh đó trong mục lục, thêm u: 'tên-tệp.html' vào cuối dòng.

Xong. Không phải sửa gì thêm.

Bước ba trông đúng như thế này. Trước khi sửa:

{ n: 10, p: 'Satipaṭṭhāna Sutta', v: 'Kinh Niệm Xứ' },

Sau khi sửa:

{ n: 10, p: 'Satipaṭṭhāna Sutta', v: 'Kinh Niệm Xứ', u: 'trungbo-010-niem-xu.html' },

Muốn bài kinh mang nhãn đỏ MỚI một thời gian thì thêm moi: true nữa. Chừng một hai tháng sau thì bỏ ra.

{ n: 10, p: 'Satipaṭṭhāna Sutta', v: 'Kinh Niệm Xứ', u: 'trungbo-010-niem-xu.html', moi: true },

Hai điều phải cẩn thận trong tệp ấy. Giữ nguyên dấu nháy đơn — đó là một phần của mã, không phải để trang trí. Và giữ dấu phẩy ở cuối dòng.

✦

Phần III · Đặt Tên Tệp

Quy ước đặt tênĐặt đúng ngay từ đầu thì về sau khỏi phải sửa

Chỉ dùng chữ thường, chữ số và dấu gạch ngang. Không dấu tiếng Việt, không khoảng trắng, không chữ hoa. Khuôn: tên bộ, số bài viết đủ ba chữ số, rồi vài chữ rút gọn từ tựa tiếng Việt.

Bộ	Đầu tên tệp	Thí dụ
Trường Bộ	truongbo-	truongbo-016-dai-bat-niet-ban.html
Trung Bộ	trungbo-	trungbo-010-niem-xu.html
Tương Ưng Bộ	tuongung-	tuongung-056-chuyen-phap-luan.html
Tăng Chi Bộ	tangchi-	tangchi-03-065-kalama.html
Pháp Cú	phapcu-	phapcu-01-song-yeu.html
Tiểu Tụng	không có đầu	kinh-tu-bi.html · kinh-diem-lanh.html
Tạng Luật	luat-	luat-parajika.html
Vi Diệu Pháp	vidieuphap-	vidieuphap-1-phap-tu.html

Ba chữ số là có lý do. Không có thì tệp sắp thành 1, 10, 100, 11 thay vì 1, 2, 3.

✦

Phần IV · Nên Soạn Bài Nào Trước

Một thứ tự đề nghịSoạn theo thứ tự này thì trang dùng được sớm nhất

Mục lục có hơn bốn trăm mục. Soạn tuần tự từ DN 1 thì phải hai năm nữa mới có được bài mà đoàn sinh thật sự cần. Nên soạn trước những bài mà Gia Đình mình dùng tới.

Nhóm 1 — tụng đọc thường (5 bài). Kinh Từ Bi (đã có), Kinh Điềm Lành, Kinh Châu Báu, Kinh Chuyển Pháp Luân (SN 56.11), Kinh Vô Ngã Tướng.
Nhóm 2 — dạy đoàn sinh (5 bài). Kinh Giáo Thọ Thi-Ca-La-Việt (DN 31), Kinh Kālāma (AN 3.65), Kinh Năm Điều Quán Tưởng (AN 5.57), Kinh Hiền Ngu (MN 129), Kinh Thiên Sứ (MN 130).
Nhóm 3 — pháp hành (5 bài). Kinh Niệm Xứ (MN 10), Kinh Nhập Tức Xuất Tức Niệm (MN 118), Kinh Chánh Tri Kiến (MN 9), Kinh Tất Cả Lậu Hoặc (MN 2), Kinh Nhất Dạ Hiền Giả (MN 131).
Nhóm 4 — Pháp Cú. Mỗi lần một phẩm, bắt đầu từ Phẩm Song Yếu. Hai mươi sáu phẩm là hai mươi sáu tuần — vừa đúng nửa năm sinh hoạt.
Nhóm 5 — bài dài. Kinh Đại Bát Niết Bàn (DN 16) để sau cùng. Bài này rất dài, nên soạn khi đã quen tay.

Hai mươi bài là đủ cho anh chị Huynh Trưởng dạy Phật Pháp trọn một năm. Mỗi tuần một bài thì năm tháng là xong.

✦

Phần V · Ba Việc Còn Lại

Sau khi bài lên rồiBa chỗ nên ghi thêm cho trọn

Tệp dữ liệu làm bài kinh hiện ra trong phần Tam Tạng. Còn ba chỗ khác trên website cũng nên biết tới nó.

js/search-data.js — để ô tìm kiếm ở đầu trang tìm ra bài. Chép một khối có sẵn rồi sửa lại tựa, đường dẫn, mô tả và các từ khóa. Nhớ ghi cả từ khóa không dấu, vì nhiều người gõ không dấu.
index.html — thêm một thẻ vào lưới tin mới ở trang chủ nếu bài đó đáng loan báo. Bài mới nhất đặt lên đầu.
xem-tat-ca.html — thêm một dòng vào danh mục lưu trữ, kèm nhãn “Mới”.

Với một bài kinh thường thì làm chỗ thứ nhất là đủ. Để dành thẻ ở trang chủ cho những bài đáng loan báo.

✦

Phần VI · Khi Có Trục Trặc

Ba lỗi hay gặpVà cách nhận ra ngay

Mở trang mục lục lên thấy trống trơn. Gần như chắc chắn là js/tamtang-data.js bị lỗi cú pháp — thiếu dấu phẩy, thiếu dấu nháy, hoặc thiếu dấu ngoặc. Bấm F12 trong trình duyệt, xem thẻ Console, dòng báo lỗi sẽ chỉ đúng số dòng.
Bài kinh vẫn màu xám dù đã thêm u:. Trình duyệt còn giữ bản cũ của tệp dữ liệu. Bấm Ctrl + F5. Nếu vẫn vậy thì kiểm lại chính tả tên tệp, kể cả chữ hoa chữ thường.
Bấm vào tên bài thì báo trang không tìm thấy. Tên trong u: khác với tên tệp thật. Hai bên phải giống nhau đúng từng chữ.

Một thói quen sau cùng nên giữ: tải lên xong thì mở trang bằng điện thoại chứ đừng chỉ xem trên máy. Trang nhà được xem bằng điện thoại nhiều hơn bằng máy tính rất nhiều, mà cái bảng bị tràn ngang thì chỉ ở đó mới thấy.

Bắt tay vào việc