GitHub & NBSP; là một dịch vụ web cực kỳ phổ biến để kiểm soát mã nguồn sử dụng Git để đồng bộ hóa các tệp cục bộ với các bản sao được giữ trên máy chủ của GitHub để bạn có thể dễ dàng chia sẻ và sao lưu công việc của mình.
Ngoài việc cung cấp A & NBSP; Giao diện người dùng cho kho lưu trữ mã, GitHub cũng cho phép người dùng xuất bản các trang web trực tiếp từ kho lưu trữ. Gói tạo trang web GitHub khuyến nghị là Jekyll, được viết bằng Ruby. Vì tôi là một fan hâm mộ lớn hơn của Python, tôi thích & nbsp; Pelican, một nền tảng blog dựa trên Python hoạt động tốt với GitHub.
Cả Pelican và Jekyll đều biến đổi nội dung được viết bằng Markdown hoặc ResformedText thành HTML để tạo các trang web tĩnh và cả hai trình tạo đều hỗ trợ các chủ đề cho phép tùy chỉnh không giới hạn.
Trong bài viết này, tôi sẽ mô tả cách cài đặt Pelican, thiết lập kho lưu trữ GitHub của bạn, chạy Trình trợ giúp nhanh, viết một số tệp Markdown và xuất bản trang đầu tiên của bạn. Tôi sẽ giả sử rằng bạn có một tài khoản GitHub, thoải mái với các lệnh git cơ bản và muốn xuất bản một blog bằng Pelican.
Cài đặt Pelican và tạo repo
Điều đầu tiên trước tiên, Pelican [và GHP-ISIVPORT] phải được cài đặt trên máy cục bộ của bạn. Đây là siêu dễ dàng với PIP, công cụ cài đặt gói Python [bạn có PIP phải không?]:ghp-import] must be installed on your local machine. This is super easy with pip, the Python package installation tool [you have pip right?]:
$ pip install pelican ghp-import Markdown
Tiếp theo, mở trình duyệt và tạo một kho lưu trữ mới trên GitHub cho blog mới ngọt ngào của bạn. Đặt tên cho nó như sau [thay thế tên người dùng GitHub của bạn cho ở đây và trong suốt hướng dẫn này]:
//GitHub.com/username/username.github.io
Để nó trống rỗng; Chúng tôi sẽ điền vào nó với nội dung blog hấp dẫn trong một khoảnh khắc.
Sử dụng một dòng lệnh [bạn dòng lệnh phải không?], Nhân bản kho lưu trữ Git trống của bạn vào máy cục bộ của bạn:
$ git clone //GitHub.com/username/username.github.io blog
$ cd blog
Đó là một mẹo kỳ lạ…
Đây là một mẹo không rõ ràng về việc xuất bản nội dung web trên GitHub. Đối với các trang người dùng [các trang được lưu trữ trong repos có tên username.github.io], nội dung được phục vụ từ nhánh chính.master branch.
Tôi rất thích không giữ tất cả các tệp cấu hình Pelican và các tệp đánh dấu thô trong Master, thay vào đó chỉ là nội dung web. Vì vậy, tôi giữ cấu hình Pelican và nội dung thô trong một nhánh riêng mà tôi muốn gọi nội dung. .master, rather just the web content. So I keep the Pelican configuration and the raw content in a separate branch I like to call content. [You can call it whatever you want, but the following instructions will call it content.] I like this structure since I can throw away all the files in master and re-populate it with the content branch.
$ git checkout -b content
Switched to a new branch 'content'
Cấu hình Pelican
Bây giờ là thời gian cho cấu hình nội dung. Pelican cung cấp một công cụ khởi tạo tuyệt vời có tên Pelican-Quickstart sẽ hỏi bạn một loạt câu hỏi về blog của bạn.pelican-quickstart that will ask you a series of questions about your blog.
$ pelican-quickstart
Welcome to pelican-quickstart v3.7.1.This script will help you create a new Pelican-based website.
Please answer the following questions so this script can generate the files
needed by Pelican.> Where do you want to create your new web site? [.]
> What will be the title of this web site? Super blog
> Who will be the author of this web site? username
> What will be the default language of this web site? [en]
> Do you want to specify a URL prefix? e.g., //example.com [Y/n] n
> Do you want to enable article pagination? [Y/n]
> How many articles per page do you want? [10]
> What is your time zone? [Europe/Paris] US/Central
> Do you want to generate a Fabfile/Makefile to automate generation and publishing? [Y/n] y
> Do you want an auto-reload & simpleHTTP script to assist with theme and site development? [Y/n] y
> Do you want to upload your website using FTP? [y/N] n
> Do you want to upload your website using SSH? [y/N] n
> Do you want to upload your website using Dropbox? [y/N] n
> Do you want to upload your website using S3? [y/N] n
> Do you want to upload your website using Rackspace Cloud Files? [y/N] n
> Do you want to upload your website using GitHub Pages? [y/N] y
> Is this your personal page [username.github.io]? [y/N] y
Done. Your new project is available at /Users/username/blog
Bạn có thể lấy mặc định trên mọi câu hỏi ngoại trừ:
- Tiêu đề trang web, phải là độc đáo và đặc biệt
- Tác giả trang web, có thể là tên người dùng cá nhân hoặc tên đầy đủ của bạn
- Múi giờ, có thể không ở Paris
- Tải lên các trang GitHub, đây là "y" trong trường hợp của chúng tôi
Sau khi trả lời tất cả các câu hỏi, Pelican để lại những điều sau trong thư mục hiện tại:
$ ls
Makefile content/ develop_server.sh*
fabfile.py output/ pelicanconf.py
publishconf.py
Bạn có thể kiểm tra các tài liệu Pelican để tìm hiểu cách sử dụng các tệp đó, nhưng tất cả chúng tôi đều hoàn thành công việc ngay bây giờ. Không, tôi chưa đọc tài liệu.
Giả mạo
Thêm tất cả các tệp do Pelican tạo vào nhánh nội dung của repo git cục bộ, cam kết các thay đổi và đẩy các thay đổi cục bộ vào repo từ xa được lưu trữ trên GitHub bằng cách nhập:content branch of the local Git repo, commit the changes, and push the local changes to the remote repo hosted on GitHub by entering:
$ git add .
$ git commit -m 'initial pelican commit to content'
$ git push origin content
Điều này không cực kỳ thú vị, nhưng nó sẽ hữu ích nếu chúng ta cần hoàn nguyên các chỉnh sửa cho một trong những tệp này.
Cuối cùng cũng nhận được ở đâu đó
Ok, bây giờ bạn có thể nhận được bloggy! Tất cả các bài đăng trên blog, hình ảnh, hình ảnh, PDF, v.v., sẽ sống trong thư mục nội dung, ban đầu trống. Để bắt đầu tạo một bài đăng đầu tiên và trang Giới thiệu với ảnh, nhập:content directory, which is initially empty. To begin creating a first post and an About page with a photo, enter:
$ cd content
$ mkdir pages images
$ cp /Users/username/SecretStash/HotPhotoOfMe.jpg images
$ touch first-post.md
$ touch pages/about.md
Tiếp theo, hãy mở tệp trống First-post.md trong trình soạn thảo văn bản yêu thích của bạn và thêm mục sau:first-post.md in your favorite text editor and add the following:
title: First Post on My Sweet New Blog
date:![So Schmexy][my_sweet_photo]
Hi, I am and I wrote this epic collection of Interweb
wisdom. In days of yore, much of this would have been deemed sorcery
and I would probably have been burned at the stake.?
[my_sweet_photo]: {static}/images/HotPhotoOfMe.jpg
Bây giờ bạn có ba phần nội dung web mới trong thư mục nội dung của bạn. Của nhánh nội dung. Đó là rất nhiều nội dung.
Công bố
Đừng lo; Phần thưởng đang đến!
Tất cả những gì còn lại để làm là:
- Chạy Pelican để tạo các tệp HTML tĩnh trong đầu ra: ________ 10output:
0//GitHub.com/username/username.github.io
- Sử dụng GHP-Moffort để thêm nội dung của thư mục đầu ra vào nhánh chính: ________ 11ghp-import to add the contents of the output directory to the master branch:
1//GitHub.com/username/username.github.io
- Đẩy nhánh chính địa phương vào repo từ xa: ________ 12
2//GitHub.com/username/username.github.io
- Cam kết và đẩy nội dung mới vào nhánh nội dung: ________ 13content branch:
3//GitHub.com/username/username.github.io
OMG, tôi đã làm điều đó!
Bây giờ phần thú vị là ở đây khi bạn có thể xem những gì bạn đã xuất bản cho mọi người xem! Mở trình duyệt của bạn và nhập:
//GitHub.com/username/username.github.io
4Xin chúc mừng blog mới của bạn, tự xuất bản trên GitHub! Bạn có thể theo dõi mẫu này bất cứ khi nào bạn muốn thêm nhiều trang hoặc bài viết. Viết blog hạnh phúc.