Socrates

Socrates là một máy phát điện trang web tĩnh đơn giản hướng tới blog. Bạn viết bài của bạn trong văn bản đơn giản yêu thích của bạn sang ngôn ngữ HTML (ví dụ như Markdown, dệt may) và lưu nó thành file văn bản trên đĩa cứng của bạn. Socrates sau đó đưa họ, và tạo ra một trang web HTML đầy đủ cho bạn. Miễn phí, bạn sẽ có được một trang chủ trong đó liệt kê tất cả bài viết, single trang bài viết, các trang chuyên mục, các trang lưu trữ, một trang web về và một nguồn cấp dữ liệu nguyên tử.
Cách sử dụng
Đầu tiên, bạn cần phải tạo một blog mới:
socrates -i Blog
Điều này sẽ tạo ra một thư mục blog với một cấu trúc blog đơn giản:
Blog
& Nbsp; bài viết
& Nbsp; 2010-your-post.md
& Nbsp; bố trí
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& Nbsp; phương tiện truyền thông
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Các bài viết thư mục là nơi bạn sẽ đặt các tập tin bài viết của mình. Bất cứ điều gì bắt đầu bằng _ hay. sẽ được bỏ qua. bố trí là chủ đề cơ bản của bạn hay một bản mẫu. config.yaml là một tập tin cấu hình trang web rộng. Đừng quên cập nhật các tập tin về những thông tin có liên quan.
Bạn cũng có thể tạo một blog mới trong thư mục làm việc hiện tại:
socrates -i
Khi bạn đã sẵn sàng để tạo ra trang web của bạn, bạn chạy:
socrates -g Blog
Hoặc,
socrates -g
cho thư mục hiện hành.
Điều này sẽ đặt tất cả các tập tin được tạo ra trong blog / triển khai. Sau đó bạn có thể mất một thư mục và tải nó lên máy chủ của bạn.
Cài đặt
Đầu tiên, thiết lập môi trường ảo của bạn và cài đặt pips Socrates.
virtualenv env --no-site-packages
nguồn env / bin / kích hoạt
pips cài đặt socrates
Hoặc, để lấy mã mới nhất, bạn có thể cài đặt từ Github.
pips cài đặt git -e: //github.com/honza/socrates.git#egg=socrates
Bước tiếp theo là cài đặt các mẫu của bạn. Tại thời điểm này, bạn có thể lựa chọn giữa các mẫu Django và mẫu Jinja2. Các chủ đề mặc định sử dụng Django.
Themes
Socrates hỗ trợ các mẫu Django và mẫu Jinja2. Bạn có thể xác định những khuôn mẫu cơ bạn muốn sử dụng trong các tập tin config.yaml. Có hai chủ đề cơ bản trong thư mục chủ đề để giúp bạn bắt đầu.
Text to HTML
Socrates sẽ attemp để chuyển đổi các tập tin văn bản của bạn vào HTML bằng cách sử dụng một bộ xử lý văn bản. Bạn nên xác định tên của bộ xử lý văn bản trong config.yaml. Nó phải được tất cả chữ thường. Bộ vi xử lý được hỗ trợ:
- Markdown
- Dệt
- ReStructuredText
- HTML (văn bản chưa sửa đổi)
Theo mặc định, Socrates chỉ cài đặt các bộ xử lý văn bản Markdown. Bạn có thể cài đặt những người khác với pip:
pips cài đặt dệt
pips cài đặt docutils
Phát triển
Bạn có thể bắt đầu một máy chủ phát triển đơn giản để giúp bạn trong việc phát triển .:
socrates -r Blog
Hoặc,
socrates -r
cho thư mục hiện hành.
Tài liệu
Các tài liệu được chứa trong thư mục docs và được viết bằng reStructuredText sử dụng Sphinx. Các tài liệu được dễ dàng đọc trong một trình soạn thảo văn bản chuẩn. Tuy nhiên, bạn có thể xây dựng một phiên bản HTML như vậy:
pips cài đặt Sphinx
cd docs /
làm html
mở _build / html / index.html
Hoặc, bạn có thể xem các phiên bản trực tuyến của các tài liệu mới nhất

Tính năng .

• Familiar Django và Jinja2 mẫu
• đơn giản cài đặt qua pip
• Markdown, reStructuredText, hỗ trợ dệt
• cấu hình YAML
• feed Atom
• trang Github tương thích

Yêu cầu :

• Python