Xây dựng blog đơn giản với Octopress 3 và Github

Octopress is an obsessively designed toolkit for writing and deploying Jekyll blogs. Pretty sweet, huh? – Octopress

Octopress là một framework design cho Jekyll. Gọi là framework nghe có hơi to tát - một cách ngắn gọn, Octopress là một bộ template/tools/plugin giúp cho việc generate static site đơn giản hơn.

Trong khuôn khổ bài viết này, mình xin hướng dẫn các bạn sử dụng Octopress để tạo 1 blog đơn giản, thêm bài viêt, page.

Xong màn dạo đầu... Tiến hành luôn cho nó nóng.

Yêu cầu:

Hệ điều hành Linux hoặc Mac OS. Máy cần cài sẵn Ruby, RubyGems, NodeJS (để hộ trợ CoffeeScript, còn không dùng CoffeeScript thì không có cũng được).

Đầu tiên, chúng ta cần cài đặt octopress gem từ Teminal:

gem install octopress

Tạo mới project

Tạo một project mới với Octopress CLI commands::

octopress new izweb

Kết quả thu được sau khi chạy lên trên như thế này là bạn đã thành công:

$ cd izweb
$ tree
.
├── 404.html
├── about.md
├── _config.yml
├── Gemfile
├── Gemfile.lock
├── index.md
├── _posts
│   └── 2017-08-28-welcome-to-jekyll.markdown
└── _templates
    ├── draft
    ├── page
    └── post

2 directories, 10 files

Thêm bài viết

Để tạo bài viết mới, các bạn dùng Octopress CLI commands:

octopress new post Hello World

Comand trên sẽ tạo mới 1 bài viết với tiêu đềHello Worldvà thêm vào thư mục_postsfile2017-08-28-hello-world.markdownvới nội dung như sau:

$ cat _posts/2017-08-28-hello-world.markdown 
---
layout: post
title: "Hello World"
date: 2017-08-28T16:28:42+07:00
---

Mặc định nội dung của bài post được viết dưới dạng markdown file. Nội dung bài post sẽ nằm phía dưới YAML front matter (phần nội dung nằm giữa cú pháp ---, tại đây bạn cũng có thể đặt được các biến xác định trước và biến tùy chỉnh, chẳng hạn như Categories, Tags và permalink. Chi tiết các bạn tham khảo thêm tại Jekyll Documentation).

View bài viết

Để view được bài viết vừa thêm, trước tiên cần chạy lệnh:

$ jekyll build

Jekyll sẽ tự động kiểm tra mọi thay đổi trên các file trong project của bạn và build vào trong thư mục_site

Bây giờ chúng ta chạy lệnh:

$ jekyll serve

Access vào địa chỉ http://127.0.0.1:4000 bạn sẽ thấy trang web của mình