Phương pháp cài đặt hệ thống hỗ trợ Re: VIEW trên Windows10

[tuhocvba]

Bạn cần đăng nhập để thấy đính kèm

1. Hệ thống hỗ trợ viết Re: VIEW là gì?
Vào tháng 5 năm 2018 tôi đãccaiif đặt hệ thống hỗ trợ viết Re: VIEW. Re: VIEW là công cụ chuyển đổi file txt được viết bằng ngôn ngữ markup (tuhocvba hiểu là html) thành Epub hay là PDF.

Bạn cần đăng nhập để thấy link

có giải thích về Re: VIEW có thể tham khảo thêm.
Những bậc thầy cho việc tạo Ebook thường sử dụng Re: VIEW để tạo ra những cuốn sách điện tử PDF, Epub đầy ma mị.

Spoiler

Bạn cần đăng nhập để thấy đính kèm

Từ markup file có thể xuất ra các định dạng sau:

• Epub
• PDF (Latex)
• HTML
• TEXT
• Web HTML
• Markdown
• InDesign XML

Re: VIEW được phát triển bởi Minero Aoki vào khoảng năm 2002. Sau đó, Kenshi Muto tiếp quản việc phát triển và bảo trì.
Bạn có thể google từ khóa re:view kmuto để tìm hiểu thêm thông tin.
2. Nền tảng (platform) nào?
Re: VIEW được viết bằng ngôn ngữ Ruby. Nên tôi nghĩ là miễn Ruby hoạt động là được, không quan trọng nền tảng nào, đó có thể là Mac OS, Linux,... Tuy nhiên tôi lại không tìm thấy ví dụ cài đặt trên Windows.
Mà lúc này thì tôi đang sử dụng máy tính Windows 10 cho nên tôi nghĩ mình muốn khởi động Re: VIEW trên Windows10.
Nếu bạn sử dụng WSL chạy Linux trên Windows, bạn có thể thoải mái sử dụng Re: VIEW trên Windows.
(Còn nữa)
Nguồn:

Bạn cần đăng nhập để thấy link

 

[tuhocvba]

3. Cài đặt Ruby
Bạn truy cập

Bạn cần đăng nhập để thấy link

và ấn nút Download.
Chọn phiên bản RUby có kèm Devkit phù hợp với Windows. Máy tính của tôi là Win64 bits nên tôi chọn Ruby+Devkit 3.1.2-1 (x64). Nếu là Win 32bits thì bạn chọn x86.
Sau khi cài đặt xong Ruby thì màn hình thiết định cài đặt MSYS2 hiện ra. (tuhocvba: Cứ ấn Enter chờ kết thúc là được).

Sau khi cài đặt xong, trên máy tính bạn tìm tới Start Command Prompt with Ruby và chạy lệnh sau để xác nhận phiên bản ruby đã được cài.

ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x64-mingw32]

4. Cài đặt Tex.
Bạn tham khảo

Bạn cần đăng nhập để thấy link

nhé.

5. Cài đặt Re: VIEW
Trên Start Command Prompt with Ruby, bạn chạy lệnh sau:

gem install review

Quá trình cài đặt xong sẽ trông như thế này:

gem install review
Fetching: image_size-1.5.0.gem (100%)
Successfully installed image_size-1.5.0
Fetching: rouge-3.1.1.gem (100%)
Successfully installed rouge-3.1.1
Fetching: rubyzip-1.2.1.gem (100%)
Successfully installed rubyzip-1.2.1
Fetching: review-2.5.0.gem (100%)
Successfully installed review-2.5.0
Parsing documentation for image_size-1.5.0
Installing ri documentation for image_size-1.5.0
Parsing documentation for rouge-3.1.1
Installing ri documentation for rouge-3.1.1
Parsing documentation for rubyzip-1.2.1
Installing ri documentation for rubyzip-1.2.1
Parsing documentation for review-2.5.0
Installing ri documentation for review-2.5.0
Done installing documentation for image_size, rouge, rubyzip, review after 25 seconds
4 gems installed

Sau khi cài đặt xong Re: VIEW ta sẽ xác nhận phiên bản bằng lệnh:

review

review version

Trong phần dịch này tôi không dùng hình ảnh minh họa vì nghĩ mọi thứ đã đơn giản rồi. Nếu muốn bạn có thể tham khảo

Bạn cần đăng nhập để thấy link

.

 

[tuhocvba]

6. Sử dụng Re: VIEW

Chức năng	Command
Tạo bản thảo	review-init Tên_Bản_Thảo
Tạo EPUB	review-epubmaker YAML_ĐịnhNghĩa
Tạo PDF	review-pdfmaker YAML_ĐịnhNghĩa
Tạo Web	review-webmaker YAML_ĐịnhNghĩa

7. Tạo bản thảo

＞ review-init sample
＞

Bản thảo đã đuwocj tạo ra. Ta xác nhận bằng lệnh tree:

＞ tree /A /F sample
フォルダー パスの一覧:  ボリューム SYS
ボリューム シリアル番号は 00000029 68BC:341C です
PI￥MYREVIEW￥SAMPLE
|   catalog.yml
|   config.yml
|   Gemfile
|   Rakefile
|   sample.re
|   style.css
|
+---doc
|       catalog.ja.md
|       catalog.md
|       customize_epub.ja.md
|       customize_epub.md
|       format.ja.md
|       format.md
|       format_idg.ja.md
|       makeindex.ja.md
|       makeindex.md
|       pdfmaker.ja.md
|       pdfmaker.md
|       preproc.ja.md
|       preproc.md
|       quickstart.ja.md
|       quickstart.md
|       writing_vertical.ja.md
|       writing_vertical.md
|
+---images
|       cover.jpg
|
+---layouts
+---lib
|   ＼---tasks
|           review.rake
|
＼---sty
        jumoline.sty
        reviewmacro.sty

File Name	Cách sử dụng
catalog.yml	Mô tả cấu trúc chương danh mục (mục lục)
config.yml	Mô tả cài đặt tài liệu
Gemfile	Tệp quản lý gói ngôn ngữ Ruby
Rakefile	Tệp định nghĩa nhiệm vụ xây dựng ngôn ngữ Ruby (rake)
sample.re	Tệp văn bản bản thảo Re: VIEW
style.css	File css của HTML, Epub
images/	Thư mục lưu trữ hình ảnh
layouts/	Mô tả cài đặt bố cục cho các tệp HTML và ePub
sty/	Định kiểu thư mục vị trí tệp cho Tex

 

[tuhocvba]

8. Tạo Epub
tuhocvba: Trước hết cần di chuyển con trỏ về thư mục sample.

cd C:\Users\user\sample

Sau đó chạy lệnh sau để tạo epub

＞ review-epubmaker config.yml
＞

File Epub đã được tạo ra trong thư mục sample.
9. Tạo PDF

＞ review-pdfmaker config.yml
compiling sample.tex
・・・

10. Tạo Web

＞ review-webmaker config.yml
＞

File index.html sẽ được tạo ra trong thư mục sample\webroot.

 

[tuhocvba]

Bổ sung:
Vì file sample.re không có nội dung gì, bạn có thể mở lên bằng notepad chỉ có dấu "=" mà thôi. Nên bạn hãy chép nội dung này vào file đó (UTF-8).

= はじめてのRe:VIEW

//lead{
このドキュメントは、@<b>{Re:VIEW}についての紹介です。
//}

== Re:VIEWとは

@<b>{Re:VIEW}は、電子書籍向けの簡易なマークアップ言語で記述したテキストファイルを
EPUBやPDFなどの形式に変換するツールセットです。
@<b>{Re:VIEW}は、2002年ごろに青木峰郎さんが開発しました。その後、武藤健志さんが開発・保守を引き継いでいます。

インターネットで@<b>{Re:VIEW}に関する情報を検索しようとすると、「レビュー」に関する記事がたくさんヒットしてしまいます。
そこで、検索のキーワードに開発者の「Kenshi MUTO」さんの名前を含めて「re:view kmuto」で検索すると@<b>{Re:VIEW}関係の情報が検索できます。


@<href>{https://github.com/kmuto/review/, Re:VIEW　公式リポジトリ}

@<href>{https://github.com/kmuto/review/blob/master/doc/format.ja.md/, Re:VIEW　フォーマットガイド}

@<href>{https://github.com/kmuto/review/blob/master/doc/quickstart.ja.md/, Re:VIEW　クイックスタートガイド}

== Re:VIEWの文書変換

@<b>{Re:VIEW}は、マークアップファイル(.re)で書いた原稿から下記文書を出力することができます。

 * PDF (LaTex)
 * EPUB
 * HTML
 * Web HTML
 * InDesign XML

== バージョン情報

@<b>{Re:VIEW}のバージョン情報は、@<table>{Version_Info} を参照してください。


//table[Version_Info][バージョン情報]{
モジュール    バージョン
--------------------------------------
Windows    Windows10 Home 1709
Ruby    2.5.1p57
TexLive    3.14159265 Tex Live 2018
Re:VIEW    2.5.0
//}

Lưu lại và tạo lại file epub để xem thành quả nhé. Mình thấy nó khá đẹp.