biên niên sử - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

biên niên sử - Một trình biên dịch blog đơn giản.

SYNOPSIS

biên niên sử [tùy chọn]

Tùy chọn đường dẫn:

--comments Chỉ định đường dẫn đến thư mục nhận xét tùy chọn.
--config Chỉ định tệp cấu hình để đọc.
--input Chỉ định thư mục đầu vào để sử dụng.
--output Chỉ định thư mục để ghi đầu ra vào.
--theme-dir Chỉ định đường dẫn đến các mẫu chủ đề.
--theme Chỉ định chủ đề để sử dụng.
--pattern Chỉ định kiểu tệp để làm việc.
--url-prefix Chỉ định tiền tố cho blog trực tiếp.
--sitemap-prefix Chỉ định tiền tố cho sơ đồ trang web.

Tùy chọn mục nhập blog:

--format Chỉ định định dạng của các mục nhập của bạn, HTML / dệt / đánh dấu.

Lệnh trước & sau khi xây dựng:

--pre-build Chỉ định một lệnh để thực thi trước khi xây dựng blog.
--post-build Chỉ định một lệnh để thực thi khi blog đã được xây dựng.
--pre-filter Một lệnh để lọc từng mục blog trước khi chuyển đổi HTML.
--post-filter Một lệnh để lọc từng mục blog sau khi chuyển đổi HTML.

Tùy chọn sắp xếp:

--recent-date-first Hiển thị các mục nhập gần đây trước tiên trong chế độ xem kho lưu trữ.
--recent-tags-first Hiển thị các mục nhập gần đây đầu tiên trong chế độ xem thẻ.

Tùy chọn đếm:

--entry-count = N Số lượng bài viết hiển thị trên chỉ mục.
--rss-count = N Số lượng bài viết cần đưa vào nguồn cấp dữ liệu chỉ mục RSS.

Tính năng tùy chọn:

--author Chỉ định địa chỉ email của tác giả
--comment-days Chỉ định số tuổi tối đa của bài viết để chấp nhận bình luận.
--date-archive-path Bao gồm ngày trong kho lưu trữ.
- Buộc sao chép các tệp tĩnh từ chủ đề blog.
--lang Chỉ định ngôn ngữ sử dụng để định dạng ngày tháng.
--lower-case Chữ thường viết thường tất cả các tên tệp được xuất.
--no-archive Không tạo trang lưu trữ.
--no-cache Không sử dụng các tính năng memcached tùy chọn, ngay cả khi có sẵn.
- không có lịch Không sử dụng lịch tùy chọn theo chỉ mục.
--no-comment Không cho phép đăng bình luận.
--no-sitemap Không tạo sơ đồ trang.
- không có thẻ Không tạo ra bất kỳ trang thẻ nào.
--no-xrefs Không tạo ra bất kỳ tham chiếu chéo nào.

Tùy chọn trợ giúp:

--help Hiển thị thông tin trợ giúp cho tập lệnh này.
--manual Đọc hướng dẫn sử dụng cho tập lệnh này.
--verbose Hiển thị thông tin gỡ lỗi hữu ích.
--version Hiển thị số phiên bản và thoát.

ĐÔI NÉT VỀ CHÚNG TÔI

Chronicle là một công cụ đơn giản để chuyển đổi một bộ sưu tập các tệp văn bản,
nằm trong một thư mục duy nhất, vào một blog bao gồm tĩnh
Tệp HTML.

Nó chỉ hỗ trợ tối thiểu các tính năng được yêu cầu
hữu ích:

* Hỗ trợ gắn thẻ.

* Hỗ trợ RSS.

* Hỗ trợ lưu trữ.

Những thiếu sót rõ ràng là:

* Thiếu hỗ trợ cho nhận xét tức thì.

* Thiếu hỗ trợ pingback / trackback.

Phải nói rằng nó là một hệ thống mạnh mẽ, ổn định và hữu ích.

BLOG FORMAT

Định dạng của các tệp văn bản mà chúng tôi xử lý rất quan trọng đối với đầu ra
các trang. Mỗi mục nhập sẽ trông giống như sau:

Tiêu đề: Đây là tiêu đề của bài đăng trên blog
Ngày: 2 tháng 2007 năm XNUMX
Thẻ: một, hai, ba, thẻ dài

Văn bản của mục nhập của bạn ở đây.

LƯU Ý: Tiêu đề PHẢI được phân tách với phần nội dung của mục nhập ít nhất bằng dấu
dòng trống duy nhất.

Trong ví dụ này, chúng ta có thể thấy rằng bản thân mục nhập đã được mở đầu trước
với một tiêu đề nhỏ. Một tiêu đề mục nhập chứa ba dòng tùy chọn,
nếu chúng không có mặt thì có các giá trị mặc định hợp lý như được mô tả
phía dưới.

Định dạng của ngày đầu ra có thể được thay đổi thông qua việc sử dụng
Tùy chọn dòng lệnh B <--lang> (hoặc tùy chọn "lang = french" phù hợp trong
tệp cấu hình), nhưng ngày của chính mục nhập phải được chỉ định trong
Tiếng Anh.

Tiêu đề: Mô tả tiêu đề của bài đăng. Nếu không có tên tệp của mục nhập được sử dụng
thay thế. "Chủ đề:" cũng có thể được sử dụng.
Chủ đề: Đây là từ đồng nghĩa với 'Tiêu đề:'.
Ngày: Ngày bài viết được viết. Nếu không có thời gian tạo tệp sẽ được sử dụng
thay thế.
Xuất bản: Tiêu đề này bị xóa khỏi tất cả các mục nhập và được sử dụng bởi bộ đệm biên niên sử
kịch bản.
Thẻ: Bất kỳ thẻ nào cần được liên kết với mục nhập, được phân tách bằng dấu phẩy.

Định dạng của mục nhập được giả định là HTML, tuy nhiên có hỗ trợ
để viết các mục của bạn ở cả hai định dạng dệt và đánh dấu.

Định dạng của các mục nhập được chỉ định thông qua đối số B <--format> hoặc
thông qua cài đặt "format: foo" trong tệp biên niên sử của bạn.

Định dạng của các mục nhập được giả định là toàn cầu; đó là tất cả các mục nhập của bạn
sẽ được giả định là ở cùng một định dạng. Tuy nhiên, bạn có thể thêm một
tiêu đề giả "format: foo" cho các mục nhập cụ thể nếu bạn muốn viết
các mục cụ thể ở một định dạng khác.

Để cho phép sự linh hoạt trong việc xử lý các mục nhập, mỗi mục nhập blog sẽ
được chuyển qua tập lệnh lọc B
cho phép bạn sửa đổi việc xử lý này ở một vị trí duy nhất. Cái này
script cho phép các mục được cập nhật thông qua các bộ lọc cả trước và sau
chuyển đổi sang HTML. Để biết thêm chi tiết, vui lòng xem trang chủ
script đó.

CẤU HÌNH

Cấu hình của phần mềm là tối thiểu và thường được thực hiện
thông qua các đối số dòng lệnh. Tuy nhiên, có thể lưu cài đặt
trong tệp global / etc / Chroniclerc hoặc mỗi người dùng ~ / .chroniclerc
tập tin.

Nếu bạn muốn, bạn có thể chuyển tên của tệp cấu hình khác cho
tập lệnh có cờ B <--config>. Điều này sẽ được đọc sau
hai tệp trước đó và có thể ghi đè bất kỳ cài đặt nào hiện có.

Tệp cấu hình chứa các dòng như sau:

input = / home / me / blog

output = / var / www / blog

định dạng = đánh dấu

Các phím không xác định được bỏ qua.

CHỌN LƯU TRỮ

Để tăng tốc độ xây dựng lại một blog lớn, trình biên dịch có thể sử dụng
Trình nền bản ghi nhớ, nếu được cài đặt và có sẵn.

Để cài đặt cái này, trong hệ thống Debian GNU / Linux, hãy chạy:

apt-get update
apt-get cài đặt memcached libcache-memcached-perl

Bạn có thể vô hiệu hóa hành vi lưu vào bộ nhớ đệm này với --no-cache và xem phần
hiệu ứng với --verbose.

CHỌN LỊCH

Nếu có sẵn mô-đun 'HTML :: CalendarMonthSimple' thì mỗi blog sẽ
chứa một chế độ xem tháng đơn giản của tháng hiện tại dựa trên chỉ mục.

Để tắt tính năng này, hãy gọi chương trình bằng '--no-calendar'.

CHỌN BÌNH LUẬN

Được bao gồm với mã biên niên sử, bạn sẽ tìm thấy tệp
cgi-bin / comments.cgi.

Tệp này được thiết kế để viết các nhận xét đã gửi cho địa phương
hệ thống tập tin của máy chủ web của bạn. Nếu bạn cài đặt và chỉnh sửa
ở đầu tập lệnh mà bạn có thể bao gồm
bình luận trong blog của bạn.

Tóm lại, có ba điều bạn cần làm:

Cài đặt tập lệnh CGI và chỉnh sửa đường dẫn khi bắt đầu.
Sao chép các nhận xét đầu ra vào nguồn blog địa phương của bạn.
Chạy lại tập lệnh này với --comments =. / Path / to / comments

Điều này sẽ bao gồm các nhận xét trong đầu ra tĩnh. Hơn
hướng dẫn rõ ràng được cung cấp trong tệp 'BÌNH LUẬN'
bao gồm trong bản phân phối.

Sử dụng biên niên sử trực tuyến bằng các dịch vụ onworks.net