Posts Tagged txt2tags

Writing book with txt2tags

Di posting yang lalu kita sudah belajar bagaimana memanfaatkan txt2tags untuk melakukan konversi file text ke HTML. Muncul keinginan sekiranya tools ini dapat kita gunakan untuk membuat sebuah buku.  Setelah membaca tutorial resminya di sini, tergeraklah segera untuk mencoba menggunakan tools ini untuk membuat sebuah buku.

Rules:

  • Setiap bab disimpan di folder tersendiri.
    Simpan semua file yang berkaitan dengan bab tersebut, termasuk sub-sub folder yang diperlukan. Hal ini pun untuk menghindari conflik apabila buku yang kita buat di kerjakan oleh tim. Masing masing orang dalam tim berkonsentrasi pada bab yang dibahasnya tanpa mengganggu bab yang sedang dikerjakan oleh yang lain.
  • Untuk setiap file pokok bahasan tertentu semisal bab.1.t2t, bab.2.t2t, dst hanya berisi “content” dari bahasan tanpa konfigurasi apapun.
  • Siapkan sebuah file master semisal master.t2t dan tentukan konfigurasi yang akan digunakan semisal: jenis  konversi, opsi tampilan, opsi layout document, dll.
  • Gunakan style dengan memanfaatkan CSS agar tampilan halaman hasil konversi menjadi lebih cantik.

Perhatikan gambar berikut:

book-view

Perhatikan bagian Daftar Isi, terlihat bahwa artikel/buku terdiri dari dua pokok bahasan (ICS dan Remote Desktop) dimana halaman tersebut merupakan konversi 3 file (ics.t2t, remote.t2t dan master.t2t)  setelah mengikuti aturan main seperti disebutkan diatas.

Kita mulai saja yuk ?

  1. Simpan script css berikut, dan berinama writing-book.css. Simpan di folder yang sama dengan file master.t2t
    body
    	{
    	font: normal 14pt sans-serif;
    	text-align:justify;
    	margin: 3em;
    	padding: 3em 4em 2em 4em;
    	border: 2px solid black;
    	}
    #toc ol
    	{
    	padding: 1em;
    	}
    #body h1
    	{
    	border-width: 0px 0px 1px 0px;
    	border-style: solid;
    	margin-top: 3em;
    	}
    #body p, #body ul, #body ol
    	{
    	margin-left: 3em;
    	}
    #body li
    	{
    	/* to make IE happy */
    	margin-top: 0em;
    	}
    a
    	{
    	text-decoration: none;
    	}
    blockquote
    	{
    	margin-left: 5em;
    	margin-top: 2em;
    	font-style: italic;
    	border-top: 0px solid black;
    	border-bottom: 1px solid black;
    	background: #FFFFBB;
    	padding: 15px;
    	}
    code
    	{
    	font-style:italic;
    	}
    hr
    	{
    	margin-top:3em;
    	}
    div.body pre
    	{
    	background: #FFFFBB;
    	padding: 15px;
    	border: 1px dashed black;
    	}
    div.toc {
    	margin-top: 15pt;
    	margin-bottom: 15pt;
    	padding: 8pt;
    	border: 1px solid black;
    	background: #FFFFBB;
    }
    	{
    	font: normal 14pt sans-serif;
    	text-align:justify;
    	margin: 3em;
    	padding: 3em 4em 2em 4em;
    	border: 2px solid black;
    	}
    #toc ol
    	{
    	padding: 1em;
    	}
    #body h1
    	{
    	border-width: 0px 0px 1px 0px;
    	border-style: solid;
    	margin-top: 3em;
    	}
    #body p, #body ul, #body ol
    	{
    	margin-left: 3em;
    	}
    #body li
    	{
    	/* to make IE happy */
    	margin-top: 0em;
    	}
    a
    	{
    	text-decoration: none;
    	}
    blockquote
    	{
    	margin-left: 5em;
    	margin-top: 2em;
    	font-style: italic;
    	border-top: 0px solid black;
    	border-bottom: 1px solid black;
    	background: #FFFFBB;
    	padding: 15px;
    	}
    code
    	{
    	font-style:italic;
    	}
    hr
    	{
    	margin-top:3em;
    	}
    div.body pre
    	{
    	background: #FFFFBB;
    	padding: 15px;
    	border: 1px dashed black;
    	}
    div.toc {
    	margin-top: 15pt;
    	margin-bottom: 15pt;
    	padding: 8pt;
    	border: 1px solid black;
    	background: #FFFFBB;
    }
  2. Siapkan file bab.1.t2t, bab.2.t2t atau apapun lah namanya (perhatikan aturan penulisannya agar dapat dikonversi dengan baik oleh txt2tags) tanpa konfigurasi apapun. Pastikan anda mengosongkan 4 baris pertama dari file-file tersebut.

  3. Tambahkan konfigurasi berikut untuk file master.t2t, pastikan konfigurasi ini tertulis pada baris ke 5 dari dari file tersebut. Catatan: baris 1=judul, baris 2=author, baris 3=tanggal penulisan artikel.
  4. %! target : xhtml
    %! style  : writing-book.css
    %! options: -n --toc --css-sugar --css-inside -o index.html
    
    %%toc
    
    %!include : bab.1.t2t
    ---------------------
    %!include : bab.2.t2t
  5. Konversikan file master.t2t dengan txt2tags
  6. Dan perhatikan hasilnya, seharusnya terstruktur dan memiliki tampilan seperti contoh gambar diatas.

Cukup tutorialnya, dan silahkan di praktikkan.
Semoga membantu.

Note:
Gunakan browser Firefox untuk hasil view dan cetak terbaik dari halaman web yang dihasilkan dalam tutorial ini.

Download file contoh tutorial diatas.

Tinggalkan sebuah Komentar

TXT2TAGS, Minimalist tools for writers

Txt2tags yang lebih dikenal sebagai “document generator” adalah sebuah tools yang mampu melakukan konversi sebuah file text ke berbagai format seperti HTML, XHTML, SGML, LaTeX, Lout, Man Page, Wikipedia, DokuWiki, MoinMoin, MagicPoint, PageMaker, Plain text dengan hanya “satu kali klik”. Bayangkan, kita tidak perlu repot mengetahui bahasa-bahasa aneh (tag) untuk setiap jensi dokumen diatas untuk membuat sebuah dokumen. Extremnya, kita cukup memiliki sebuah file text dan kita bisa menggenerate dan mempublishnya ke dalam format lain tanpa perlu tahu apa-apa, enak bukan :) . Lebih detailnya tentang fitur yang dimiliki oleh txt2tags silahkan baca di alamat berikut http://txt2tags.sourceforge.net/features.html

Langsung saja kita coba deh (versi windows):

  • Untuk pengguna Linux download txt2tags di sini, atau bagi anda pengguna Windows silahkan download di sini.
  • Installasikan seperti biasa
  • Kemudian kita buat sebuah file text dan berinama “contoh-konversi-txt2tags.txt”, mudahnya anda ketik contoh file text berikut:
Minimalist tools for Writers (txt2tags)
Cecep Khaerudin
Tangerang, %%mtime(%d/%m/%Y)
% IT Dept. SMKN 1 Panongan Tangerang Banten Indonesia
% Kampus SMKN 1 Panongan
% Jl. Ds. Peusar Perum Mekar Asri Citra Raya Kecamatan Panongan 15710
% Kabupaten Tangerang Banten Indonesia Telp. 0215963277

=Tentang txt2tags=

Txt2tags adalah sebuah tool konversi yang ditulis dgn bahasa //Pyton// yang mampu meng-generate sebuah
dokumen HTML, XHTML, SGML, LaTex, Man Page, MoinMoin, Magic Point dan PageMaker dari hanya sebuah file text
dengan cepat.

=Download txt2tags for windows=

- Pilih versi yang kita perlukan, apakah Compact Version dimana diperuntukkan bagi komputer yang
sudah terinstall Python atau Full Version bagi komputer yang belum terinstall Phyton
- Download
- Install
- Jalankan program
- Selesai

=Mencoba txt2tags=
+ buat tulisan seperti contoh ini (download file [%%infile %%infile] berikut)
+ simpan file tersebut dan beri nama "contoh-konversi-txt2tags.txt"
+ buka aplikasi, Start -->All Programs --> txt2tags -- txt2tags

[images/txt2tags.jpg]

+ pilih target konversi, misal HTML
+ klik tombol "Convert"
+ buka hasilnya dengan menggunakan browser
+ selesai

--------------------
=Contoh=
==Beautifier==

Huruf cetak **TEBAL** didapat dengan mengapit huruf dengan dua tanda bintang (*).

Huruf cetak //miring/italic// didapat dengan mengapit huruf dengan dua tanda slash (/)

Berlaku juga huruf **//Cetak Tebal dan Miring//** dengan mengapit dua tanda bintang dan hash (*/huruf/*)

Huruf __bergaris-bawah__ didapat dengan mengapit huruf dengan dua tanda low dash (_)

==Pre-formated Text==
Huruf untuk coding atau preformated text
```
   Ini contoh preformated text yang biasa digunakan untuk coding
   bentuk **cetak tebal** maupun //cetak miring//
   tidak akan di ``interpretasikan``
```

Bisa digunakan untuk satu baris tersendiri seperti:
``` prompt$ ls /etc/apt/sources.list

ataupun dalam satu kalimat yang sama seperti ``prompt$ ls /etc/apt/sources.list``

Contoh lain:

```
   C:\Documents and Settings\user>route print
   ===========================================================================
   Interface List
   0x1 ........................... MS TCP Loopback interface
   0x2 ...00 90 f5 8c d7 80 ...... SiS191 Ethernet Controller - Packet Scheduler
   Miniport
   ===========================================================================
   ===========================================================================
   Active Routes:
   Network Destination        Netmask          Gateway       Interface  Metric
           127.0.0.0        255.0.0.0        127.0.0.1       127.0.0.1       1
     255.255.255.255  255.255.255.255  255.255.255.255               2       1
   ===========================================================================
   Persistent Routes:
   None
```

Terlihat bedanya bukan ?, Cukup apit kalimat yang dimaksud dengan dua tanda berikut (``)

==List==
Untuk mebuat sebuah list cukup awali kalimat dengan tanda **plus** (+) maupun **dash** (-)

===Plain List===
Tanda dash (-) adalah tanda default yang digunakan untuk membuat list, cukup berikan tanda spasi bagi list
dibawahnya, contoh:

- dunia
  - asia
    - indonesia
      - banten
        - tangerang
	- serang
      - jakarta
        - jakarta utara
	- jakarta barat
- mars
  - entahlah ?

===Numbered List===
Sama seperti plain list, bedakan dengan menggunakan tanda plus (+)

+ satu
+ dua
+ tiga
  - campuran
  - list berbeda
    + hitung lagi
    + ...
+ empat

===Definition List===
Definition list di awali dengan memberikan tanda titik dua (:). definisi diletakkan di baris berikutnya
dengan meberikan spasi, contoh

: jeruk
  buah berwarna orange
: aple
  buah berwarna hijau
: durian
  buah berduri
: buah lainnya:
 + nagka
 + cempedak
   - jambu
   - melon

==Tabel==
Gunakan tanda | untuk menghasilkan sebuah tabel. Dua tanda || di awal cell adalah heading. contoh:

|| heading 1 | heading 2 | heading 3 |
 | cel 1.1   | cel 1.2   | cel 1.3 |
 | cel 2.1   | cel 2.2   | cel 2.3 |

Tanpa tanda | di akhir cell berarti tanpa border

|| heading 1 | heading 2 | heading 3
 | cel 1.1   | cel 1.2   | cel 1.3
 | cel 2.1   | cel 2.2   | cel 2.3 

==Gambar==
Cukup simpan gambar di folder yang sama dengan file text, dan sisipkan dengan tag berikut:
``[gambar/photo.jpg]`` tanpa spasi apapun.

==Tanggal==
Makro ``%%date`` akan menunjukkan ``current date``

Contoh, waktu saat ini adalah %%date dalam bentuk format ISO ``YYYYMMDD``

Bisa lebih spesifik dalam format berikut ``%%date(%d/%m/%Y)`` contoh %%date(%d/%m/%Y)

== Cosmetics :) ==
Spesial entitas seperti alamat email (papi.nazwa@gmail.com)
dan alamat URL (http://papinazwa.wordpress.com) akan di deteksi secara automagically
selama masih dalam satu baris.

--------------------
^ gari tipis atapun garis tebal v (minimal 20 karakter)
====================

=Hasil Konversi=
Hasil konversi dari file Text di atas ke bentuk HTML terlihat seperti berikut:

[images/txt2tags-convert-html.jpg]

Semoga membantu.
--------------------
(Note: Download file [%%infile %%infile])
  • Buka aplikasi txt2tags; Start –> All Programs –> txt2tags –> txt2tags
  • Pilih target konversi, dalam contoh ini target konversi adalah HTMLtxt2tags
  • Klik tombol “Convert”
  • Buka file “contoh-konversi-txt2tags.html” hasil konversi tersebut dengan menggunakan web browser

    txt2tags-convert-html

  • Selesai

Dan silahkan konversi file/tulisan/artikel/buku anda ke dalam format yang lain.

Dan bagi  anda yang tidak sabar, coba download di sini.
Semoga membantu !

Tinggalkan sebuah Komentar