OpenOffice.org 1.1

Menerjemahkan Berkas Help
Menggunakan Mini Framework

Isi

Yang Diperlukan	3

Sistem Operasi	3

Java Runtime Environment	3

Perl	3

Pemasangan	3

Penggunaan	5

Apa guna struktur direktori?	5

Apa yang dilakukan script?	7

Apa yang tidak bisa dilakukan script?	9

Jika pada awalnya Anda tidak berhasil...	9

Bagaimana cara membuat berkas help	10

Kebutuhan	10

LANGKAH 1: Menyediakan berkas-berkas masukan	10

LANGKAH 2: Menjalankan Script	11

LANGKAH 3: Menyediakan berkas-berkas bagi pemasangan	11

Aturan-aturan dalam menerjemahkan berkas	11

Berkas-berkas di bawah ini harus diterjemahkan secara manual:	11

Berkas-berkas di bawah ini diterjemahkan secara otomatis:	12

Berkas-berkas berikut mungkin perlu penyesuaian:	12

Berkas-berkas di bawah ini tidak perlu diterjemahkan ataupun tidak perlu penyesuaian:	12

Revisi bahasa Inggris: Agustus 2003 Penulis awal bahasa Inggris: Frank Peters (fpe@sun.com) Edisi bahasa Indonesia: Juni 2004 Penulis edisi bahasa Indonesia: I Gede Wijaya S (jaya@te.pdft.ugm.ac.id)

Yang Diperlukan

Sistem Operasi

Script menggunakan perintah-perintah pada sistem Windows (2000).

Java Runtime Environment

Anda memerlukan JRE 1.3.1 atau versi yang lebih tinggi.

Perl

Script membutuhkan Perl 5. Script telah diuji coba dengan menggunakan Perl 5.6.1. Paket benchmark harus sudah dipasang agar dapat menggunakan fungsi-fungsi yang berkaitan dengan waktu.

Pemasangan

Buat sebuah direktori sebagai tempat menyusun bagian-bagian berkas Help, misalnya SO6_Help

Buka kompresi L10NHelp.zip dan masukkan kedalam direktori yang telah dibuat sebelumnya dengan tetap menjaga struktur direktori awal L10NHelp.zip.

Tambahkan sub direktori {SO6_Help}/program ke variabel path Anda.

Sesuaikan lokasi (path) dengan letak intrepeter Perl pada baris pertama script perl createhelp.pl:

#!lokasi/perl.exe

Sesuaikan Set global variables pada script createhelp.pl seperti contoh dibawah ini:

#--------------------------------------------------------#
# Set global variables
#--------------------------------------------------------#
# adjust these:
$root_dir = 'C:\SO6_Help\\';
$java_dir = 'C:\JavaSoft\JRE\1.3.1';
$CLASSPATH = "$java_dir\\lib\\rt.jar;$java_dir\\lib\\tools.jar";

Masukkan lokasi direktori bagi pembukaan berkas kompresi zip ke $root_dir, misalkan:

$root_dir = 'C:\SO6_Help\\';

Pastikan menggunakan quote tunggal (') dan diakhiri dengan garis miring terbalik ganda (\\).

Masukkan lokasi direktori tempat memasang Java JRE ke $java_dir, misalkan:

$java_dir = 'C:\JavaSoft\JRE\1.3.1';

Pastikan menggunakan quote tunggal (') dan tidak diakhiri dengan garis miring terbalik ganda (\\).

Masukkan lokasi rt.jar dan tools.jar di $CLASSPATH dipisahkan oleh sebuah semicolon (;), misalkan:

$CLASSPATH = "$java_dir\\lib\\rt.jar;$java_dir\\lib\\tools.jar";

Pastikan menggunakan quote ganda (“) dan garis miring terbalik ganda (\\). Pisahkan lokasi menggunakan sebuah semicolon (;) dan gunakan variabel $java_dir yang telah ditentukan oleh contoh diatas untuk menunjukkan direktori “root” lokasi pemasangan Java .

Anda tidak perlu mengubah nilai-nilai lain yang terletak di bagian atas script perl jika Anda menggunakan struktur direktori yang telah diberikan sebelumnya.

Penggunaan

Apa guna struktur direktori?

Ketika Anda membuka kompresi berkas zip kedalam sebuah direktori yang telah dipilih, Anda akan melihat sebuah struktur direktori berbentuk pohon dengan cabang-cabang sebagai berikut:

{INSTALLDIR}

etc

input

etc

{lang}

etc

text

picture

output

{lang}

program

classes

stylesheets

Indexing

PreTransformation

source

installset

{lang}

etc	Direktori ini berisikan berkas-berkas tambahan seperti DTD bagi document help, yang tidak diperlukan bagi produksi berkas help. Anda dapat menggunakan DTD ini untuk mengecek keabsahan berkas-berkas help terjemahan.
input	Direktori ini berisikan berkas-berkas masukkan, yaitu berkas-berkas help hasil terjemahan. Script akan mengambil berkas yang berada pada direktori ini.
input\etc	Direktori ini berisikan berkas-berkas tambahan yang diperlukan bagi produksi help bagi semua bahasa seperti berkas stylesheet transformasi utama main_transform.xsl dan STOPLIST yang berisikan kata-kata yang harus diabaikan dari proses penyusunan indeks.
input\{lang}	Direktori ini harus dibuat oleh Anda dan didalamnya terdapat cabang-cabang yang didalamnya terdapat berkas-berkas help xml text\, dengan didalamnya terdapat grafik-grafik dan direktori yang berisikan berkas-berkas tambahan etc\ yang bergantung kepada suatu bahasa.
input\{lang}\etc	Direktori ini berisikan berkas-berkas tambahan yang bersifat khusus bagi suatu bahasa, seperti topik basis data *.txt yang khusus bagi sistem operasi (platform) tertentu, berkas-berkas konfigurasi yang terlihat seperti susunan sebuah pohon, stylesheet yang telah diubah sesuai keinginan, dan lain-lain.
output	Direktori ini berisikan sub direktori yang didalamnya terdapat berkas-berkas help yang dapat digunakan bagi tujuan percobaan.
output\{lang}	Direktori ini dibuat ketika script mulai dijalankan. Diasumsikan bahwa berkas masukan diletakkan pada input\newspeek, direktori output\newspeek kemudian akan dibuat.
program	Direktori ini berisikan pustaka-pustaka dan program-program yang digunakan oleh script.
program\classes	Direktori ini berisikan kelas-kelas java yang digunakan oleh script.
stylesheets\ Indexing	Direktori ini berisikan stylesheet yang digunakan oleh script untuk membuat berkas-berkas indeks.
stylesheets\ PreTransformation	Direktori ini berisikan stylesheet yang digunakan oleh script untuk mengubah berkas-berkas xml.
source	Anda dapat meletakkan struktur kode sumber berkas help pada tempat sesuai pilihan favorit Anda disini sebagai sumber referensi bagi Anda dalam menerjemahkan. Direktori yang terdapat disini dapat digunakan sebagai bahan referensi bagi struktur direktori masukan.
installset	Direktori ini berisikan sub direktori- sub direktori sebagai tempat hasil akhir keluaran berkas help.
installset\{lang}	Disini mungkin yang Anda inginkan: tempat berkas kompresi help yang dapat digunakan untuk pembuatan sebuah versi help.

Apa yang dilakukan script?

Script perl sangat bergantung pada struktur direktori yang benar (lihat keterangan sebelumnya) dan berkas xml yang sah pada direktori-direktori help. Script menghasilkan pembuatan help pada langkah (1+)6. Silakan lihat script perl tersebut untuk melihat komentar-komentar pada prosedur tertentu.

Berkas-berkas yang dihasilkan oleh script akan diletakkan pada direktori-direktori yang bergantung kepada suatu bahasa (dinamakan seperti direktori masukan). Pada cara ini, multi bahasa (secara teori) dapat diproses dalam satu waktu (jika komputer mampu) dengan mulai menjalankan script lebih dari satu kali dengan parameter-parameter yang berbeda. Bahasa yang berbeda seharusnya tidak mempengaruhi (belum diuji coba).

Persiapan

Setelah menyusun variabel-variabel global – beberapa diantaranya harus disesuaiakan terlebih dahulu, lihat "Pemasangan" – direktori tujuan bagi berkas-berkas keluaran berada pada output dan dibuatlah installset.

Langkah 1: Memperbaharui basis data topik

Basis data topik ASCII yang bergantung kepada sistem operasi tertentu dapat ditemukan di {install}\input\{lang}\etc, misalnya membaca swriter_WIN.txt atau sbasic_UNIX.txt dan semua judul yang terdapat pada berkas-berkas tersebut akan diperbaharui dengan menggunakan judul-judul yang dibaca dari berkas-berkas yang telah diterjemahkan yang ada pada struktur {install}\input\{lang}\text. Berkas-berkas yang telah diperbaharui disimpan, misalnya sebagai swriter_new_win.txt.

Berkas-berkas yang baru saja dibuat ini kemudian diubah ke basis data binari menggunakan program txt2db.exe yang terdapat pada direktori {install}\program. Basis data yang dihasilkan, sebagai contoh swriter.db diletakkan pada direktori {install}\output\{lang}. Basis data ini dibutuhkan oleh langkah berikutnya.

Langkah 2: Memperbaharui berkas-berkas pada struktur pohon

Berkas-berkas yang ada yang berekstensi *.tree dari {install}\input\{lang}\etc kemudian dibaca dan semua elemen
<topic id="some_id">Unlocalized string</topic> dan
<node id="some_id" title="Unlocalized string">
diperbaharui pada Langkah 1 dengan menggunakan basis data ASCII dan menampilkan topik atau judul node baru.

Harap diperhatikan bahwa beberapa bagian dari berkas-berkas ini harus diterjemahkan secara manual (lihat Aturan-aturan dalam menerjemahkan berkas pada halaman 9).

Berkas-berkas *.tree yang telah diproses diletakkan pada direktori {install}\output\{lang}, misalkan, {install}\output\{lang}\swriter.tree.

Langkah 3: Membuat grafik bagi berkas kompresi dan basis data

Grafik-grafik yang terdapat pada cabang struktur masukan, misalkan {install}\input\icelandic\picture dikompresi kedalam berkas zip dan grafik basis data pada picture.txt dari direktori {install}\input\{lang}\etc diubah ke bentuk binari menggunakan program txt2db.exe.

Berkas-berkas kompresi grafik picture.jar dan basis data grafik picture.db diletakkan pada direktori {install}\output\{lang}.

Langkah 4: Membuat indeks

Berkas-berkas indeks dibutuhkan bagi pencarian teks secara penuh (fulltext search) dibuat dengan menggunakan program-program dan pustaka-pustaka Java yang ditemukan pada direktori {install}\program dan {install}\program\classes, serta stylesheet XSL ditemukan pada direktori {install}\stylesheets\indexing.

Agar langkah 4 ini bisa bekerja dengan baik, Java 1.3.1 harus dipasang dengan benar. Langkah 4 ini membutuhkan waktu yang paling lama, jadi harap bersabar.

Berkas-berkas indeks diletakkan pada sub direktori {application}.idx yang terletak di direktori {install}\output\{lang}, misalkan {install}\output\icelandic\swriter.idx, dan berisikan berkas-berkas yang dibutuhkan oleh mesin pencari (search engine).

Langkah 5: Mengubah dan mengompresi berkas-berkas xml

Berkas-berkas xml yang terdapat pada cabang teks dari struktur masukan diubah dengan menggunakan program-program dan pustaka-pustaka Java yang ada pada direktori {install}\program dan {install}\program\classes dan begitu pula stylesheet XSL dapat ditemukan pada direktori {install}\stylesheets\pretransformation. Langkah 5 ini juga membuat berkas-berkas kompresi bagi aplikasi-aplikasi dan diletakkan ke dalam direktori {install}\output\{lang}\, misalkan {install}\output\icelandic\swriter.jar.

Langkah 6: Mengakhiri proses

Semua berkas-berkas tambahan dikumpulkan ke dalam direktori {install}\output\{language}\, dan termasuk didalamnya adalah berkas-berkas konfigurasi *.cfg, yang harus diterjemahkan secara manual, stylesheet bagi berkas help menampilkan custom.css yang perlu disesuaikan dan tergantung kepada kebutuhan bahasa/huruf dan dokumen kesalahan err.html yang juga harus diterjemahkan secara manual.

Berkas-berkas yang dibutuhkan tersebut kemudian dikompilasi dan dimasukkan ke dalam berkas kompresi dan diletakkan ke dalam direktori {install}\installset\{language}\. Dari direktori ini kemudian berkas-berkas tersebut dapat disalin ke dalam struktur kode sumber yang bersesuaian. Harap diperhatikan bahwa tidak peduli bahasa yang Anda hasilkan, Anda akan selalu mendapatkan berkas-berkas *99.* yang ada pada direktori {install}\installset\{language}\.

Hasil keluaran

Setelah script menjalankan tugasnya, maka Anda akan mendapatkan sekumpulan berkas yang ada pada direktori {install}\installset\{language}\ yang siap untuk diletakkan pada struktur kode sumber.

Anda juga akan mendapatkan sekumpulan berkas dan direktori yang ada dalam direktori {install}\output\{language}\ yang kemudian bisa disalin ke dalam direktori help\{language} pada direktori pemasangan StarOffice yang bisa digunakan untuk keperluan percobaan (ingatlah selalu untuk membuat direktori cadangan bagi direktori asli). Berkas help yang baru akan tersedia setelah Anda menyalakan kembali (restart) (jangan lupa keluar dari program quick starter!).

Apa yang tidak bisa dilakukan script?

Script ini tidak berarti terbebas dari segala kesalahan. Script ini tidak mengecek tentang adanya pemasangan Java yang benar atau hal-hal lain yang diperlukan seperti misalnya direktori yang sebelumnya telah ada. Script ini juga akan menimpa ulang berkas-berkas keluaran yang telah ada yang terletak pada direktori {install}\output atau {install}\installset.

Jika pada awalnya Anda tidak berhasil...

Tidak ada yang bekerja sebagaimana mestinya

...cek apakah pemasangan Java (Java 1.3.1) dilakukan dengan benar, JRE saja sudah cukup tetapi saya bukan ahli Java dan saya biasa bekerja dengan JDK.

...cek apakah pemasangan Perl (Perl 5.6.1) dilakukan dengan benar. Paket benchmark harus juga dipasang (pemasangan bawaan, default). Jika Anda tidak memiliki akses ke paket benchmark atau tidak ingin fitur tersebut, cukup dengan menghapus semua baris yang berisikan kata seperti misalnya "...new Benchmark", "...timediff", "use Benchmark".

...apakah Anda telah menyesuaikan dengan benar lokasi Perl yang ada di bagian atas script?

...apakah Anda telah menyesuaikan dengan benar lokasi interpreter Perl pada baris pertama (mungkin tidak selalu dibutuhkan)?

Pengompresian berkas gagal

...apakah Anda telah memasang dengan benar Java 1.3.1? Berkas jar.exe pada direktori {install}\program sepertinya membutuhkan Java dengan versi 1.3.1.

Langkah pembuatan indeks atau perubahan, gagal

...apakah Anda mengecek keabsahan berkas-berkas xml dari help dengan menggunakan DTD yang telah disediakan pada direktori {install}\etc?

Bagaimana cara membuat berkas help

Kebutuhan

Menerjemahkan data

Anda bisa menemukan detail bagi aturan-aturan proses penerjemahan dengan melihat "Aturan-aturan dalam menerjemahkan berkas" di halaman 9.

LANGKAH 1:	Menyediakan berkas-berkas masukan

Buat sebuah direktori {lang} bagi berkas-berkas terjemahan sebagai sub direktori dari {install}\input. Nama direktori tidak penting tetapi kami menyarankan agar Anda menggunakan nama yang bisa memperjelas sesuatu, misalkan {install}\input\icelandic.

Buat sebuah direktori etc sebagai sub direktori dari {lang}, misalkan {install}\input\icelandic\etc.

Salin semua berkas-berkas tambahan ke dalam sub direktori etc. Termasuk didalamnya adalah *.cfg, custom.css, err.html, *.tree, *.txt. Harap diperhatikan bahwa tidak semua berkas tersebut harus diterjemahkan secara manual (lihat catatan diatas)

Salin struktur pohon berkas help terjemahan – diawali dengan sub direktori text – ke dalam sub direktori tersebut, misalkan {install}\input\icelandic\text.

Salin struktur pohon grafik berkas terjemahan help – diawali dengan sub direktori picture – ke dalam sub direktori tersebut, misalkan. {install}\input\icelandic\picture.

LANGKAH 2:	Menjalankan Script

Jalankan script Perl menggunakan sintaksis-sintaksis berikut:

perl createhelp.pl [lang] [platform] [lang_iso] [country_iso] [v]

yaitu

lang:	sub direktori {lang} (anak direktori {install}\input) yang struktur pohonnya (diawali dengan direktori teks) ditemukan, misalkan icelandic. Sebenarnya sub direktori ini dapat memiliki nama sesuai keinginan Anda. Sub direktori ini hanya mengacu pada direktori tempat ditemukannya berkas-berkas masukan dan berkas-berkas keluaran sementara disimpan.

platform:	sistem operasi tujuan bagi pembuatan berkas help, pilih WIN atau UNIX. Gunakan hanya kedua nilai tersebut.

lang_iso:	kode bahasa bagi terjemahan bahasa yang ingin dihasilkan, berdasarkan ketentuan ISO 639, misalkan e. g. is bagi icelandic. Parameter ini penting bagi pembuatan indeks dengan menggunakan sistem lokal yang benar.

country_iso:	kode negara menurut ISO 3166, misalnya IS bagi Iceland. Parameter ini diperlukan bagi pembuatan indeks dengan menggunakan sistem lokal yang benar.

v:	(opsional) sedikit lebih banyak mengeluarkan keterangan tentang proses yang terjadi

Menunggu script selesai menjalankan tugasnya

Tergantung pada kecepatan komputer maka proses yang dijalankan script membutuhkan waktu kira-kira satu jam.

LANGKAH 3:	Menyediakan berkas-berkas bagi pemasangan

Berkas yang dihasilkan adalah delapan berkas zip yang terletak di direktori {install}\installset\{lang} yang kemudian dapat dipindahkan ke direktori yang bersesuaian dengan direktori pembuatan StarOffice. Delapan berkas zip tersebut adalah:

shared99.zip, sbasic99.zip, scalc99.zip, schart99.zip, sdraw99.zip, simpress99.zip, smath99.zip, swriter99.zip

Aturan-aturan dalam menerjemahkan berkas

Berkas-berkas di bawah ini harus diterjemahkan secara manual:

Berkas topik help *.xml di direktori {install}\input\{lang}\text harus diterjemahkan seluruhnya. Termasuk didalamnya adalah judul berkas pada tag <dc:subject> di dokumen, karena dari tag inilah script mendapat keterangan tentang judul topik bagi basis data. Harap jangan menggunakan html entities seperti misalnya &apos; pada tag ini, tetapi gunakanlah karakter-karak tersandi UTF-8. Juga, perbaharuilah elemen bahasa <dc:language>en-US</dc:language> agar cocok dengan bahasa baru yaitu terjemahan bahasa. Setelah proses penerjemahan, keabsahan berkas dapat diuji menggunakan DTD {install}\etc\so-help.dtd.

Jika diperlukan, grafik tampilan yang ada di {install}\input\{lang}\pictures harus diterjemahkan. Berkas hasil terjemahan harus memiliki nama yang sama, harus diletakkan pada direktori yang sama dan harus memiliki ukuran lebar dan tinggi (dalam ukuran byte tidak menjadi masalah). Jika ukuran lebar dan tinggi berbeda, maka seperti grafik akan tampak terkena distorsi, jika ukuran grafik tidak disesuaikan pada berkas help yang bersesuaian.

Bagian-bagian di struktur pohon {install}\input\{lang}\etc\*.tree harus disesuaikan secara manual:
Atribut title tag <help_section>.
Atribut title dari segala tag <node> dengan atribut id yang diawali dengan "N" atau "C". seperti misalnya <node id="C01" title="Unlocalized">

Berkas-berkas konfigurasi input\{lang}\etc\*.cfg. Anda hanya perlu menyesuaikan atribut title dan language.

Dokumen kesalahan input\{lang}\etc\err.html.

Berkas-berkas di bawah ini diterjemahkan secara otomatis:

Basis data topik berkas help {install}\input\{lang}\etc\*.txt diperbaharui oleh script. Berkas-berkas asli dibiarkan tanpa tersentuh, berkas-berkas yang diperbaharui diberi nama, seperti misalnya swriter_new_win.txt. Jikapun berkas terakhir tersebut ada maka script akan menimpa berkas tersebut.

Topik informasi khusus pada berkas-berkas di struktur pohon {install}\input\{lang}\etc\*.tree diperbaharui oleh script. Bagaimanapun juga beberapa bagian berkas harus diterjemahkan secara manual.

Berkas-berkas berikut mungkin perlu penyesuaian:

Stylesheet {install}\input\{lang}\etc\custom.css mungkin perlu disesuaikan jika bahasa penerjemahan membutuhkan huruf yang berbeda. Juga mungkin perlu penyesuaian untuk ketentuan bahasa yang khusus.

Direktori {install}\input\etc\STOPLIST berisikan sebuah daftar kata-kata yang harus diabaikan dalam pembuatan indeks bagi pencarian teks secara menyeluruh. Sayangnya, berkas ini tidak bisa hanya ditujukan pada suatu bahasa tertentu, sehingga Anda harus menambahkan semua kata yang harus diabaikan bagi semua bahasa yang ingin dihasilkan. Untuk tahap awal, berkas tersebut berisikan kata-kata paling umum dalam bahasa Inggris yang harus diabaikan.

Berkas-berkas di bawah ini tidak perlu diterjemahkan ataupun tidak perlu penyesuaian:

Semua berkas diatas {install}\input\{lang} dengan pengecualian pada direktori {install}\input\etc\STOPLIST mungkin dapat diabaikan.

Basis data grafik {install}\input\{lang}\etc\picture.txt dapat diabaikan.

8

OpenOffice.org 1.1 – Menerjemahkan Berkas Help	8

Frank Peters

2002-02-18T12:54:34

Frank Peters