mezzanine-mdown

lửng-mdown cung cấp các vật dụng và các bộ lọc cho tầng lửng cho phép các quản trị viên để sử dụng định dạng markdown để tạo ra nội dung trang web của họ, chứ không phải bằng cách sử dụng trình soạn thảo TinyMCE để tạo ra html sử dụng trong các loại nội dung phong phú, chẳng hạn như các trang giàu và viết blog.
Cài đặt
Lấy gói
pip:
người sử dụng @ home: ~ $ pip cài đặt lửng-mdown
easy_install:
người sử dụng @ home: ~ $ easy_install lửng-mdown
Chuẩn bị các phương tiện truyền thông tĩnh
Sử dụng ứng dụng staticfiles xuất sắc, các tập tin tĩnh mdown của nên có được chọn tự động.
Nếu ứng dụng staticfiles không phải là phong cách của bạn, bạn sẽ cần phải xác định vị trí các vị trí cài đặt cho gói mdown (thường là thư mục trang web gói dịch viên python của bạn) và sao chép / symlink mdown / static / mdown vào thư mục site_media dự án của bạn.
Cấu hình
Trước hết, thêm mdown vào danh sách các INSTALLED_APPS trong mô-đun thiết lập dự án của bạn.
Với các ứng dụng được cài đặt, bạn cần phải thực hiện một vài sự lựa chọn. Bạn sẽ phải xác định RICHTEXT_WIDGET_CLASS và giá trị RICHTEXT_FILTER trong mô-đun cài đặt của bạn.
RICHTEXT_WIDGET_CLASS
Gói này cung cấp 2 lựa chọn cho thiết lập này.
mdown.forms.WmdWidget
& Nbsp; Kích hoạt trình soạn thảo văn bản giàu WMD. (Đề nghị)
mdown.forms.PlainWidget
& Nbsp; Sử dụng một Textarea trơn (không có trình soạn thảo văn bản giàu có).
RICHTEXT_FILTER
Một lần nữa, có 2 lựa chọn cho thiết lập này.
mdown.filters.codehilite
& Nbsp; Renders nội dung sử dụng markdown với phần mở rộng codehilite kích hoạt.
mdown.filters.plain
& Nbsp; Renders nội dung sử dụng định dạng vanilla markdown.
Các bước tắm
Pygments Styles
Sử dụng pygments_styles lệnh quản lý, bạn có thể tạo ra css để tô màu cho khối mã phân tích của bộ lọc codehilite.
Lưu ý: điều này đòi hỏi pygments được cài đặt (sử dụng pips cài đặt pygments hoặc easy_install pygments để sử dụng tính năng này).
Gọi các lệnh mà không có args để xem tin nhắn sử dụng và danh sách các chủ đề màu có sẵn trên hệ thống của bạn .:
người sử dụng @ home: ~ / mysite $ ./manage.py pygments_styles
Cách sử dụng: pygments_styles ./manage.py
Đề màu có sẵn:
& Nbsp; borland
& Nbsp; bw
& Nbsp; đầy màu sắc
& Nbsp; mặc định
& Nbsp; ... [snip] ...
Gọi với tên của chương trình như một đối số sẽ in css để stdout, mà bạn có thể chuyển hướng đến một tập tin như vậy:
người sử dụng @ home: ~ / mysite $ ./manage.py pygment_styles đầy màu sắc> site_media / css / pygments.css
Trong additon để phương pháp này chương trình duy nhất, các lệnh cũng chấp nhận lá cờ --all, mà sẽ tạo ra phong cách cho tất cả có sẵn, nhưng với một sự khác biệt quan trọng: mỗi chương trình được bắt đầu bằng tên của nó như là một tên lớp css. Đây là tiện dụng trong quá trình phát triển chủ đề như bạn có thể nhanh chóng chuyển đổi các chương trình pygments chỉ bằng cách thiết lập các lớp về thẻ cơ thể để bạn lựa chọn các chương trình mà không cần phải tạo lại các file css liên tục.
Một khi bạn đã có một tập tin css tạo, chỉ cần thêm nó vào mẫu cơ sở trang web của bạn để có được mã của bạn "đẹp" được in.
Đang cập nhật Theme Templates
Chủ đề đã được dựa trên các chủ đề mặc định và đã được tạo ra trước khi phát hành 0.11.3 lửng sẽ rất có thể không có các richtext_filter áp dụng cho nội dung phong phú. Để khắc phục điều này, bạn chỉ cần có để cập nhật các mẫu cho các loại nội dung để các bộ lọc được sử dụng.
Ví dụ, trong các theme mặc định, các templates / blog / blog_post_detail.html có một dòng mà đã được cập nhật từ ::
{{Blog_post.content | an toàn}}
để ::
{{Blog_post.content | richtext_filter | an toàn}}
. Chỉ cần đảm bảo rằng các bộ lọc an toàn đến sau richtext_filter

Yêu cầu :

• Python