# Dokumentasi LibreOffice ID

Kumpulan dokumentasi (sebagian besar adalah README) dari proyek, layanan, dan panduan dari Komunitas LibreOffice Indonesia. Mengapa memilih Gitbook? Model penulisan di layanan Gitbook ini sangatlah mudah bahkan untuk pengguna awam sekalipun. Dengan demikian, semoga dapat memudahkan siapa saja yang ingin ikut berkontribusi menulis dokumentasi.

#### Tautan-Tautan Terkait

* [Grup Telegram](https://t.me/LibreOfficeID)
* [Repository Github](https://github.com/libreofficeid)

#### Layanan LibreOffice Indonesia

* [Glosarium](https://glosarium.libreoffice.id/)
* [Lumbung](https://lumbung.libreoffice.id/)

#### Sosial Media

* Twitter:  [@libreOfficeID](https://twitter.com/libreofficeid)
* Instagram: [@libreofficeid](https://www.instagram.com/libreofficeid/)&#x20;
* [Youtube](https://www.youtube.com/channel/UCBgSzRofowjVhsK-D92TFmg)
* Surel: <humas@libreoffice.id>


# Daftar Agenda LibreOffice ID

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Lvlysnqc--8KOn14TC6%2F-Lvlz18mUACpiE6XqTSy%2Fimage.png?alt=media\&token=3795f65c-657d-42e0-9a6e-df54f923bae0)

|                                                                        |                                                                        |
| ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| [Tahun 2018](/agenda-libreoffice-id/daftar-agenda-libreoffice-id/2018) | [Tahun 2019](/agenda-libreoffice-id/daftar-agenda-libreoffice-id/2019) |


# 2018

Daftar Kegiatan LibreOffice Indonesia Sepanjang Tahun 2018

| No. | **Acara**                           | **Venue**                                                                  | **Tanggal**     | **Penyelenggara & Koordinator**           | <p><strong>Keterangan?</strong><br><strong>Tautan Pendaftaran/</strong><br><strong>Situs/Poster</strong></p> |
| --- | ----------------------------------- | -------------------------------------------------------------------------- | --------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| 01  | LibreOffice Conference Indonesia    | Politeknik Elektronika Negeri Surabaya                                     | 23--25/Mar/2019 | <p>LibreOffice ID</p><p>(Ahmad Haris)</p> | <https://2018.libreoffice.id>                                                                                |
| 02  | Penerjemahan LibreOffice  Gresik    | Warunk Upnormal, Jl. Doktor Wahidin No. 111, Kecamatan Kebomas, Jawa Timur | 3&4/Nov/2018    | GresikDev & Kelompok Linux Arek Suroboyo  |                                                                                                              |
| 03  | Penerjemahan LibreOffice Yogyakarta | Kantor Midtrans Jalan Gandok Baru No.46, Depok, Yogyakarta                 | 1&2/Des/2018    | <p>Libreoffice ID</p><p>(Rania Amina)</p> |                                                                                                              |


# 2019

Daftar Kegiatan LibreOffice Indonesia Sepanjang Tahun 2019

| **No** | **Acara**                                                  | **Venue**                                                                                   | **Tanggal**                  | **Penyelenggara & Koordinator**                                 | <p><strong>Keterangan/</strong><br><strong>Tautan Pendaftaran/</strong><br><strong>Situs/Poster</strong></p> |
| ------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| 01     | Penerjemahan LibreOffice Malang                            | DOT Techno Valley Malang                                                                    | 5&6/Jan/2019                 | <p>Komunitas GNU/Linux Malang (KLiM)</p><p>(Samsul Ma'arif)</p> |                                                                                                              |
| 02     | Penerjemahan LibreOffice Surabaya                          | Ruang Training APJII Jawa Timur                                                             | 12&13/Jan/2019               | Kelompok Linux Arek Suroboyo (KLAS)                             |                                                                                                              |
| 03     | Penerjemahan LibreOffice Pasuruan                          | STMIK Yadika Bangil, Jl. Bader No. 9, Kalirejo, Bangil, Pasuruan                            | 19&30/Jan/2019               | PasuruanDev                                                     |                                                                                                              |
| 04     | Penerjemahan LibreOffice Solo                              | DiLO Solo, Jl. Prof. Dr. Supomo No. 66, Punggawan, Banjarsari, Kota Surakarta, Jawa Tengah. | 26&27/Jan/2019               | <p>LibreOffice ID</p><p>(Rifki Aziz)</p>                        |                                                                                                              |
| 05     | Penerjemahan LibreOffice STIMATA                           | Kampus STIMATA Ruang A.3.2                                                                  | 16&17/Feb/2019               | STIMATA Malang                                                  |                                                                                                              |
| 06     | Penerjemahan LibreOffice Jember                            | LAB SAC Fasilkom UNEJ                                                                       | <p>23&24/Feb/</p><p>2019</p> | <p>LibreOffice ID</p><p>(ArievleOne)</p>                        |                                                                                                              |
| 07     | Workshop LibreOffice Stikom                                | Ruang Expo Lt. 1 Stikom                                                                     | 02/Mar/2019                  | Stikom & KLAS                                                   |                                                                                                              |
| 08     | Dilo Roadshow Lokakarya Libreoffice 6.2                    | <p>Lab. C203 Gd. D4</p><p>Politeknik Elektronika Negeri Surabaya</p>                        | 13/Apr/2019                  | OSC PENS, KoLU, & KLAS                                          |                                                                                                              |
| 09     | Gotong Royong Membuat Template Jurnal Ilmiah               | Lab Fasilkom R D204                                                                         | 20/Jul/2019                  | LibreOffice ID & Cangkru'an KLAS                                | Mentor: Moh. Noor Al Azam, S.Kom, M.Mt                                                                       |
| 10     | The Importance of Using Open Document Format in Education  | Ruang Rapat Gedung D Univ. Narotama Surabaya                                                | 10/Okt/2019                  | Narotama, LibreOffice ID, dan KLAS                              | <p>Pemateri:</p><p>Shinji Enoki (Jepang)</p>                                                                 |
| 11     | Penjaminan Kualitas LibreOffice                            | Ruang Training APJII Jawa Timur                                                             | 19/Nov/2019                  | APJII Jawa Timur & KLAS                                         |                                                                                                              |
| 12     | <p>Kopdar#3 KLJ :<br>LibreOffice Seru dan Mengasyikkan</p> | SMKN 2 Jember                                                                               | 14/Des/2019                  | <p>LibreOffice ID</p><p>Komunitas Linux Jember</p>              | <https://s.id/kopdar3-klj>                                                                                   |


# LibreOffice Theme Changer (GUI)

## LO-TC GUI

Extension to manage LibreOffice Theme. This extension is based on [LibreOffice Theme Changer](https://github.com/raniaamina/libreoffice-theme) by Rania Amina & Sofyan Sugianto.

## Target

### Starting Point

* [x] Wireframe and concept
* [x] UI Development

### Manage theme for LibreOffice 6.x

* [x] Import Theme (we will use \*.lotc as theme format)
* [x] Apply theme to LibreOffice 6.x
* [x] Remove imported theme from LO-TC list
* [x] Create own theme

### Current Support

The target of LO-TC Development mainly is for LibreOffice 6.2 or newer. LibreOffice available in various package or instalation method, especially for Linux. So, we make some priority stage.

* Linux
  * [x] Install from distro repository
  * [x] Install from DEB/RPM package (from web)
  * [x] Compile from source
  * [x] Flatpak
  * [x] Snap
  * [ ] AppImage (is it needed? We still not sure to supporting LOTC in Appimage or maybe later)
* Mac OS
  * [x] Mac OS
* Windows
  * [x] Windows 7/8/8.1/10


# Build & Install

### Build Extension

To build LO-TC, just follow this steps:

```bash
# clone repository
git clone https://github.com/libreofficeid/LO-TC-GUI.git

# enter to clone directory 
cd LO-TC-GUI

# build extension
make zip
```

we have special command `make all` to everyone who wanna help us to develop this extension. This command used if you have make some update to python code, and wanna to show the update directly on your LibreOffice without re-install extension via Extension Manager. Just run `make all` then restart the LibreOffice.

{% hint style="info" %}
Some operating system doesn't provide **python3-uno** package/library which is needed to run LOTC. Please make sure that this library already installed on your system before running LOTC.
{% endhint %}

### Extension Installation

Just like other extension, you only need to import this extension via menu: Tools -> Extension Manager, then add extension. LibreOffice should restart after new extension installation.

For your information, at the first run, LO-TC will ask you for root permission to setup local environment.

Here is special note for Slatpak, Snap, and Windows user.

**Only for flatpak user**, \
please run [**lotc-flatpak-first-run.sh**](https://raw.githubusercontent.com/libreofficeid/LO-TC-GUI/master/lotc-flatpak-first-run.sh) first. LibreOffice will opened, then open menu: Tools -> Extension Manager -> add extension.

**Only for Windows user**\
After installing the extension and running it at the first time, you will be asked for many times User Account Control (UAC) for Administrator Privileges to do some modifications in LibreOffice Installation Directory. UAC will be prompted again when activating your desired theme.

**Only for Snap user**\
After installing the extension and running it at the first time, you will be noticed that you have to run additional step to make this extension works. While running desired script, it will ask for sudo password to perform some modifications of your LibreOffice's Snap installation. After that, you should reboot your PC to apply this modifications. Then, you can normally run LibreOffice Snap version.


# Interface

### LO-TC Interface

![Main Dialog](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LubhFqQ3J8KI0SOoD6x%2F-LubhGaxhTA2VpUwP1nj%2Flotc-1.png?generation=1574771695189964\&alt=media)

This is main dialog of LO-TC. All of imported theme will listed at white area. Green Mark indicate that the theme is active or used now. To see the details of each theme, just click the theme name, and detail of theme will appear. Look at picture.

![Detail of Theme](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGazO-rzX7xr73Pj%2Flotc-4.png?generation=1574825652622595\&alt=media)

Click Activate if you wanna apply this theme, or Remove to remove this theme from LO-TC list.

LO-TC can help you to creat your own theme. We use `*.lotc` as main format for LO-TC theme file. At the main dialog, click Create New Theme in order to start creating your own theme.

Please complete the required data as you see at this dialog, including Author Name, Theme Name, and path to save your directory theme.

![Create Own Theme Dialog](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGb09ZOeRtuUenYp%2Flotc-2.png?generation=1574825658520153\&alt=media)

Click Create button, to finish this step. Please go to path where your theme saved. Your next task is completing that directory so look like this tree. Don't forget to add several information about your theme into manifest.xml file.

```bash
theme-name
├── manifest.xml
├── personas
│   ├── theme-name
│   │   ├── footer.png
│   │   ├── header.png
│   │   └── preview.png
│   └── personas_list.txt
├── program
│   ├── intro.png
│   └── sofficerc
└── screenshots
    ├── screenshot-3.png
    ├── screenshot-2.png
    └── screenshot.png
```

We've provide complete guide about step by step to create own LO-TC Theme, please refer to link bellow

* LOTC Theme Guide
  * [English Version](/libreoffice-theme-changer/lotc/create-own-theme-guideline)
  * [Bahasa Indonesia](/libreoffice-theme-changer/lotc/membuat-tema-lotc)

Let say your theme already finish, you can import your theme to LO-TC by clicking Import Theme.

, navigate the file manager to directory where the lotc file saved. If the import success, your new theme will listed in main dialog.

![Import Theme Dialog](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGb277FtHRACTioG%2Flotc-3.png?generation=1574825652524458\&alt=media)

####


# Create Own Theme Guideline

LibreOffice Theme Changer or LOTC (read: Lotis), is an extension to set the appearance of themes in LibreOffice. This extension was developed by the LibreOffice Indonesia Community. The LOTC source code can be seen in the [Github LibreOffice ID](https://github.com/libreofficeid/LO-TC-GUI) repository. Following are the steps to create a custom theme for LOTC. Before you start creating themes, make sure you have installed this extension in your LibreOffice. The installation guide can be seen in [at this link](/libreoffice-theme-changer/lotc/libreoffice-theme-changer-gui).


# Initialize Working Directory

To create a LOTC template, please open the Theme Changer extension via the Tools menu -> Add-ons -> Theme Changer.

![LOTC - Main Dialog](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LubhFqQ3J8KI0SOoD6x%2F-LubhGaxhTA2VpUwP1nj%2Flotc-1.png?generation=1574771695189964\&alt=media)

Then click "Create New Theme" so that the dialog window opens as shown below.

![LOTC - Create New Theme Dialog](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGb09ZOeRtuUenYp%2Flotc-2.png?generation=1574825658520153\&alt=media)

Complete the fields in the dialog. At the bottom is the location where your new theme will be saved. Click Create when finished. At the location that you specify, a theme directory will appear with the name that you specify.


# Understanding the Directory Hierarchy

The directory created by LOTC was still empty, please complete with your new theme data. To help you find out about what needs to be added to this working directory, please pay attention to the following theme folder hierarchy.

```
your-theme-name
├── manifest.xml
├── personas
│   ├── YourThemeName
│   │   ├── footer.png
│   │   ├── header.png
│   │   └── preview.png
│   └── personas_list.txt
├── program
│   ├── intro.png
│   └── sofficerc
└── screenshots
    ├── screenshot-1.png
    ├── screenshot-2.png
    └── screenshot-3.png
```


# Preparing Image Assets

There are two kind of contents in LOTC, images and text. We have provided a template to help you set up image assets, please [download it from the Lumbung page](https://lumbung.libreoffice.id/materi/panduan-membuat-tema-untuk-lotc/). \
\
Here is a description for each image asset.&#x20;

1. **header.png** \
   The header is the image that appears at the top of the LibreOffice program, precisely in the LibreOffice menu area. This header size standard we take from the standard size of the image assets on the themes persona. We strongly recommend that designs made for this header utilize the upper right corner area. The technical reason is that this area is the safest area and does not interfere with the visibility of the icons on the menu. <br>
2. **footer.png** \
   Footer is an image that will appear in the area below the LibreOffice program. Basically, this footer will automatically hide if there is no menu open at the bottom / LibreOffice footer. The safe area for this footer is on the right hand side. <br>
3. **preview\.png** \
   Preview is an image that will be displayed on the gear **menu** -> **Options** -> **Personalization**. This preview becomes your theme's identity. The safe area for this preview image is in the middle of the area. <br>
4. **intro.png** \
   Splash is the image that first appears when you run LibreOffice. Actually there is no standard size for this splash image, but we recommend using a size that is also used by LibreOffice which is 661 x 169 pixels. You can create a splash using the templates that we have provided. <br>
5. **screenshot - \*. png** \
   Help other users to identify your theme by providing screenshots or other images that are still related to your theme or identity. LOTC displays up to 3 images, we recommend that images have a 16:9 aspect ratio.


# Preparing Configuration File

After you have prepared the image assets, now let's prepare the configuration files. Here are some configuration files that you must prepare:

1. **persona\_list.txt**<br>

   **persona\_list.txt** is a configuration file to control how our theme will be displayed. The file contains information as follows:&#x20;

   * Theme Directory Name&#x20;
   * Theme Name (will appear as a tooltip)&#x20;
   * Location of the preview file&#x20;
   * Location of the header file&#x20;
   * Footer file location&#x20;
   * Backgrond and foreground colors

   The following is an example of the format of writing the information above (for example a theme created called Rainbow).

   ```
   rainbow;Rainbow;rainbow/preview.png;rainbow/header.png;rainbow/footer.png;;#ffffff;#000000
   ```
2. **sofficerc** \
   sofficerc is a file that will control how splash will be displayed. The following is the contents of the sofficerc file and some explanations.

   ```bash
   [Bootstrap]
   CrashDirectory=${$BRAND_BASE_DIR/program/bootstraprc:UserInstallation}/crash
   HideEula=1
   Logo=1
   NativeProgress=false
   ProgressBarColor=0,0,0
   ProgressFrameColor=102,102,102
   ProgressPosition=35,153
   ProgressSize=444,8
   ProgressTextBaseline=145
   ProgressTextColor=0,0,0
   SecureUserConfig=true
   SecureUserConfigCompress=true
   SecureUserConfigExtensions=true
   SecureUserConfigMode=1
   SecureUserConfigNumCopies=2
   URE_BOOTSTRAP=${ORIGIN}/fundamentalrc
   ```

   To customize the look you only need to edit the following parameters;\
   \
   **A. Logo** \
   Parameters to determine whether the splash is displayed or not<br>

   **B. NativeProgress** \
   Displays native or custom progressbar

   \
   **C. ProgressBarColor** \
   ProgressFrameColor determines the frame color on the progressbar, this parameter uses the RGB color value<br>

   **D. ProgressPosition** \
   Determine the location of the progressbar, this parameter uses the X and Y coordinate values\
   \
   **E. ProgressSize** \
   Determining the size of the progressbar, this parameter uses the width and height values in pixels.


# Update the Manifest File

In the manifest.xml file, you actually only need to complete a few things.&#x20;

First, your social media site or url, secondly, a description of the theme that you created, and the last one is add the required links (maximum 2 links) that relate to your new theme.&#x20;

Describe your theme briefly, we recommend not exceeding 250 characters. Take advantage of links to direct users to sites that make it possible to explain themes more comprehensively.


# Generate LOTC

Basically, lotc files are zip archives containing the files that you created before. The easiest way to create this file is to archive your theme folder above in zip format, then change the zip extension to lotc by renaming it. The directory structure in the archive can be seen in the image below.

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LucJe6ziOhYov6XDVyL%2Flotc-archive.png?generation=1574825652503476\&alt=media)

If so, you can import your theme by clicking the import button in the LOTC main dialog. If successful, then when your theme is clicked, a detail window will appear as shown below.

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGazO-rzX7xr73Pj%2Flotc-4.png?generation=1574825652622595\&alt=media)

Click Activate to apply the theme, or Remove to delete the theme from the list.

{% hint style="info" %}
you can use command:`zip -r theme-name.lotc theme-name/`
{% endhint %}


# Misc

Please note that developers are not responsible for the content used to create themes. All rights and licensing issues are fully borne by the theme creator. LOTC is a tool that is still under development, please be aware that the risk is entirely borne by the user. To talk about this extension, please contact the developer or make a chat in [the LibreOffice ID Telegram group. ](https://t.me/libreofficeid)


# Membuat Tema LOTC

LibreOffice Theme Changer atau LOTC (baca: Lotis), adalah ekstensi untuk mengatur tampilan tema pada LibreOffice. Ekstensi ini dikembangkan oleh Komunitas LibreOffice Indonesia.

Kode sumber LOTC dapat dilihat pada repsitori [Github LibreOffice ID.](https://github.com/libreofficeid/LO-TC-GUI) Berikut merupakan langkah-langkah membuat tema kustom untuk LOTC. Sebelum memulai membuat tema pastikan Anda telah memasang ekstensi ini di LibreOffice Anda. Panduan pemasangan dapat dilihat pada berkas Readme pada [tautan ini.](https://github.com/libreofficeid/LO-TC-GUI)

##


# Inisialisasi Direktori Kerja

Untuk membuat teme LOTC, silakan buka terlebih dahulu ekstensi Theme Changer melalui menu **Perkakas** -> **Pengaya** -> **Theme Changer**.

![LOTC Main Dialog](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LucGC5wKqYp6rNS2Hsc%2Flotc-main.png?generation=1574825652375703\&alt=media)

Kemudian klik "Create New Theme" sehingga terbuka jendela dialog seperti pada gambar di bawah ini.

![LOTC Dialog untuk Membuat Tema](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGb09ZOeRtuUenYp%2Flotc-2.png?generation=1574825658520153\&alt=media)

Lengkapi isian pada dialog tersebut. Pada isian paling bawah adalah lokasi tempat tema baru Anda akan di simpan. Klik Create jika sudah selesai.

Pada lokasi yang telah Anda tentukan, akan muncul direktori tema dengan nama sesuai yang telah Anda tentukan.


# Memahami Hirarki Direktori Kerja

Direktori yang telah dibuat oleh LOTC tadi masihlah kosong, silakan lengkapi dengan data-data tema baru Anda. Untuk membantu Anda mengetahui tentang apa saja yang perlu ditambahkan pada direktori kerja ini, silakan perhatikan hirarki folder tema berikut ini.

```bash
nama-tema-anda
├── manifest.xml
├── personas
│   ├── NamaTemaAnda
│   │   ├── footer.png
│   │   ├── header.png
│   │   └── preview.png
│   └── personas_list.txt
├── program
│   ├── intro.png
│   └── sofficerc
└── screenshots
    ├── screenshot-1.png
    ├── screenshot-2.png
    └── screenshot-3.png
```


# Menyiapkan Aset Gambar

Konten dalam LOTC terbagi menjadi dua jenis, gambar dan teks. Kami telah menyediakan template untuk membantu Anda menyiapkan aset-aset gambar, silakan unduh di [halaman Lumbung](https://lumbung.libreoffice.id/materi/panduan-membuat-tema-untuk-lotc/) di sebelah kanan tulisan ini. Berikut adalah keterangan untuk masing-masing aset gambar.

1. **header.png** \
   &#x20;Header merupakan gambar yang tampak pada bagian atas program LibreOffice, tepatnya di area menu LibreOffice. Standar ukuran header ini kami ambil dari standar ukuran aset gambar pada tema-tema persona. Kami sangat menyarankan agar desain yang dibuat untuk header ini memanfaatkan area pojok kanan atas. Alasan teknisnya adalah karena area ini merupakan area palinga aman dan tidak mengganggu visibilitas ikon-ikon pada menu.
2. **footer.png** \
   &#x20;Footer merupakan gambar yang akan tampil pada area bawah program LibreOffice. Pada dasarnya footer ini akan tersembunyi secara otomatis apabila tidak ada menu yang terbuka pada bagian bawah/footer LibreOffice. Area aman untuk footer ini berada di sisi kanan.
3. **preview\.png** \
   &#x20;Preview merupakan gambar yang akan ditampilkan pada menu perkakas --> Opsi--> Personalisasi. Preview ini menjadi identitas tema Anda. Area aman untuk gambar preview ini berada di bagian tengah area.
4. **intro.png** \
   &#x20;Splash merupakan gambar yang pertama kali muncul ketika Anda menjalankan LibreOffice. Sebenarnya tak ada ukurab baku untuk gambar splash ini, namun kami sarankan untuk menggunakan ukuran yang juga digunakan oleh LibreOffice yaitu 661 x 169 piksel. Anda dapat membuat splash menggunakan template yang sudah kami sediakan.
5. **screenshot-\*.png** \
   &#x20;Bantu para pengguna lain untuk memngenali tema Anda dengan memberikan tangkapan layar atau gambar lain yang masih berkaitan dengan tema atau identitas Anda. LOTC menampilkan hingga 3 gambar, kami sarankan agar gambar memiliki aspek rasio 16:9.


# Menyiapkan Berkas Konfigurasi

Setelah Anda menyiapkan aset-aset gambar, sekarang mari menyiapkan berkas-berkas konfigurasi. Berikut adalah beberapa berkas konfigurasi yang harus Anda siapkan:

1. **persona\_list.txt** <br>

   **persona\_list.txt** merupakan berkas konfigurasi untuk mengatur bagaimana tema kita akan ditampilkan. Berkas terserbut memuat informasi sebagai berikut:

   * Nama Direktori Tema&#x20;
   * Nama Tema (akan muncul sebagai tooltip)
   * Lokasi berkas preview
   * Lokasi berkas header
   * Lokasi berkas footer
   * Warna backgrond dan foreground<br>

   Berikut merupakan contoh format penulisan informasi di atas (misalnya tema yang dibuat bernama ***rainbow***).

   ```bash
   rainbow;Rainbow;rainbow/preview.png;rainbow/header.png;rainbow/footer.png;;#ffffff;#000000
   ```
2. **sofficerc**\
   **sofficerc** merupakan berkas yang akan mengatur bagaimana splash akan ditampilkan. Berikut merupakan isi dari berkas sofficerc dan beberapa penjelasannya.

   ```bash
   [Bootstrap]
   CrashDirectory=${$BRAND_BASE_DIR/program/bootstraprc:UserInstallation}/crash
   HideEula=1
   Logo=1
   NativeProgress=false
   ProgressBarColor=0,0,0
   ProgressFrameColor=102,102,102
   ProgressPosition=35,153
   ProgressSize=444,8
   ProgressTextBaseline=145
   ProgressTextColor=0,0,0
   SecureUserConfig=true
   SecureUserConfigCompress=true
   SecureUserConfigExtensions=true
   SecureUserConfigMode=1
   SecureUserConfigNumCopies=2
   URE_BOOTSTRAP=${ORIGIN}/fundamentalrc
   ```

   Untuk melakukan kustomsisasi tampilan Anda hanya perlu menyunting beberapa parameter berikut;\
   \
   **A. Logo**\
   Parameter untuk menentukan apakah splash ditampilkan atau tidak\
   \
   **B. NativeProgress**\
   Menampilkan *progressbar* native atau kustom\
   \
   **C. ProgressBarColor**\
   ProgressFrameColor menentukan warna bingkai pada *progressbar*, parameter ini menggunakan nilai warna RGB\
   \
   **D. ProgressPosition**\
   Menentukan lokasi *progressbar*, parameter ini menggunakan nilai koordinat X dan Y \
   \
   **E. ProgressSize**\
   Menentukan ukutan dari *progressbar*, parameter ini menggunakan nilai lebar dan tinggi dengan satuan piksel.


# Melengkapi Berkas Manifest

Pada berkas manifest.xml, sebenarnya Anda hanya perlu melengkapi beberapa hal saja. Pertama, situs atau url media sosial Anda, kedua, deskripsi tentang tema yang Anda buat, dan terakhir adalah menyertakan tautan yang dibutuhkan (maksimal 2 tautan).

Deskripsikanlah tema Anda secara ringkas, kami menyarankan tidak melebihi 250 karakter. Manfaatkan tautan untuk mengarahkan pengguna ke situs yang memungkinkan untuk menjelaskan tema dengan lebih komprehensif.


# Membuat Berkas \*.lotc

Pada dasarnya, berkas lotc tak lain hanyalah arsip terstruktur yang memuat berkas di atas. Cara termudah untuk membuat berkas ini adalah mengarsipkan folder tema Anda di atas dengan format zip, kemudian ubah ekstensi zip menjadi lotc dengan cara me-*rename*-nya. Struktur direktori pada arsip dapat dilihat pada gambar di bawah ini.

![Struktur Berkas dalam Arsip](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LucJe6ziOhYov6XDVyL%2Flotc-archive.png?generation=1574825652503476\&alt=media)

Jika sudah, Anda dapat mengimpor tema Anda dengan mengeklik tombol impor pada *main dialog* LOTC. Jika berhasil, maka ketika tema Anda diklik maka akan muncul jendela detail seperti gambar berikut ini.

![ Detail Tema pada LOTC](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGazO-rzX7xr73Pj%2Flotc-4.png?generation=1574825652622595\&alt=media)

Klik Activate untuk menerapkan tema, atau Remove untuk menghapus tema dari daftar.


# Lanjutan

Harap diperhatikan bahwa pengembang tidak bertanggung jawab terhadap konten yang digunakan untuk membuat tema. Seluruh persolan hak dan lisensi, sepenuhnya ditanggung oleh kreator tema. LOTC merupakan perkakas yang masih dalam tahap pengembangan, harap untuk disadari bahwa risiko sepenuhnya ditanggung oleh pengguna. Untuk berdiksi seputar ekstensi ini, silakan untuk mengubungi pengembang atau membuat obrolan di grup [Telegram LibreOffice ID](https://t.me/libreofficeid).


# Disclaimer

We build LO-TC with love, but please remember to use it at your own risk. We are not responsible for the legality of the content (for example) that you use in the theme. All responsibilities are entirely held by each theme creator.

LO-TC works by changing some user settings, but the LO-TC developer does not store the user's private content at all. Any damage that occurs to the system caused by errors in the use of LO-TC (of course we never expect that), is entirely the responsibility of the user.


# Contribute

We will be very happy if you are pleased to contribute to the development of LO-TC. The issue tab is open for everyone. Before open new issue,please make sure issue that will you open isn't exist before.

Don't hesitate to contact us if you have idea to bring LO-TC more better. LO-TC is developed by LibreOffice Indonesia Community (LibreOffice ID), currently we active on [Telegram](https://t.me/LibreOfficeID).


# LIbreOffice Theme Changer (CLI)


# LOTC-CLI GUIDE (EN)

[Versi Bahasa Indonesia](/libreoffice-theme-changer/libreoffice-theme/readme-id)

## LibreOffice Theme Changer (LO-TC)

LibreOffice Theme Changer or LO-TC (read: Lotis) is a simple tool to help you change themes in LibreOffice version 6.2 (or newer). LO-TC allows you to easily replace default splash images and persona themes on LibreOffice with your own image.

###


# Themes Instalation

We provide several themes that you can choose and use directly, but you can also add your own themes that you want. Step by step how to create own them will provided in the next section.

To run LO-TC, please follow the following steps. Make sure Git is installed on your operating system.

```bash
$ git clone https://github.com/raniaamina/libreoffice-theme.git
$ cd libreoffice-theme
$ bash install.sh
```

![Selecting the Installation Method](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhG_tIBhgEAQyKid7%2Fimg-1.png?generation=1574825658682224\&alt=media)

LibreOffice supports many installation methods, each method has its own directory for storing LibreOffice configuration files. For that case, please choose the appropriate installation method so the theme can be installed correctly.

The next step, is to determine the theme you want to install. A list of available themes can be seen in the `themes` directory.

![Select Theme](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhG_vTpmWI5Uar3_E%2Fimg-2.png?generation=1574825652804503\&alt=media)

To install a theme, you are required to have root access. You will be asked to enter the root password after you choose your prefered theme to be installed. Bside of that, make sure that the LibreOffice application is not being used/running.

After the installation is complete, you can choose whether to immediately apply the selected theme or not. You can activate the theme manually through menu `tool` -> `Options`->`Personalization` in LibreOffice. Look at the following picture.

![Manual Activation](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhG_xIJSnEJRhdcD0%2Fimg-5.png?generation=1574825652467296\&alt=media)

> **SPECIAL NOTE** For now the LO-TC can run well on the Debian, openSUSE, Fedora, Ubuntu, and derivative distributions. For distros other than those mentioned, they must enter the LibreOffice path manually. Consider the following picture.
>
> ![Manually Enter Path](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhG_zW2w6ZFswF3hE%2Fimg-6.png?generation=1574825652653513\&alt=media)

### Remove the LO-TC Theme

To remove theme via LO-TC just run the command

```bash
$ bash uninstall.sh
```

then select the theme you want to delete.


# Create a Custom Theme

Please follow this steps to create a custom LibreOffice theme.

#### Understanding Directory Themes Hierarchy

The LO-TC use special directory hierarchy to make it easier for anyone who wants to create a custom theme and install it using LO-TC. Save and place each assets that will be created in the **themes** directory. LO-TC will automatically read the list of themes contained in the directory, we call them preinstalled themes.

please pay attention to the following directory hierarchy to help you find out where the assets are stored in the next steps.

```bash
themes
└── your-theme
    ├── program
    │   ├── intro.png
    │   └── sofficerc
    ├── screenshot.png
    └── share
        └── gallery
            └── personas
                ├── your-theme
                │   ├── footer.png
                │   ├── header.png
                │   └── preview.png
                └── personas_list.txt
```

\[UPDATE] We have provided additional tools to help you create a full and fast theme folder. Just run the command:

```bash
$ bash theme-creator.sh
```

then enter the name of the theme you want. Automatically the LO-TC will create a theme directory according to the name you entered under the `themes` folder.

#### Preparing Image Assets

The pictures that must be prepared to make this theme include:

1. Splash Splash is the image that appears at the first time when you run LibreOffice. Actually there is no standard size for this splash image, but we recommend using the size that is also used by LibreOffice which is 661x169 pixels. You can make a splash using the template that we have provided. [Download here](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/intro.svg)
2. Header The header is an image that appears at the top of the LibreOffice program, precisely in the LibreOffice menu area. We use the header size from the standard image size assets on Firefox persona themes. We strongly recommend that the design created for this header take advantage of the upper right corner area. The technical reason is because this area is the most save area and does not interfere with the visibility of the icons on the menu. We have prepared a header template that is ready to be modified. [Download Here](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/header.svg)
3. Footer Footer is an image that will appear in the area under the LibreOffice program. Basically this footer will be hidden automatically if there is no menu open at the bottom/footer of LibreOffice. The safe area for this footer is on the right side, please use the template that we have provided to help you create a footer. [Download Here](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/footer.svg)
4. Preview Preview is an image that will be displayed in the `tool` menu -> `Options` -> `Personalization`. This preview becomes the identity of your theme. The safe area for this preview image is in the middle of the area. Please download the preview template that we have provided. [Download Here](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/preview.svg)
5. Screenshot (optional) Help other users recognize your theme by providing screenshots when your theme is successfully installed.

#### Create Configuration Files

After you have set up image assets, let's now prepare configuration files. Here are some configuration files that we will prepare:

1. Sofficerc `sofficerc` is a file that will set how the splash will be displayed. Here is the contents of the sofficerc file followed by simple explanations.

   ```bash
   [Bootstrap]
   CrashDirectory=${$BRAND_BASE_DIR/program/bootstraprc:UserInstallation}/crash
   HideEula=1
   Logo=1
   NativeProgress=false
   ProgressBarColor=0,0,0
   ProgressFrameColor=102,102,102
   ProgressPosition=35,153
   ProgressSize=444,8
   ProgressTextBaseline=145
   ProgressTextColor=0,0,0
   SecureUserConfig=true
   SecureUserConfigCompress=true
   SecureUserConfigExtensions=true
   SecureUserConfigMode=1
   SecureUserConfigNumCopies=2
   URE_BOOTSTRAP=${ORIGIN}/fundamentalrc
   ```

   to customize splash display you only need to edit parameters, `logo`,`NativeProgress`, `ProgressBarColor`,`ProgressFrameColor`, `ProgressPosition`, and `ProgressSize`

   * Logo -- parameter to determine whether the splash is displayed or not
   * NativeProgress -- Displays *progressbar* native or custom
   * ProgressBarColor -- Specifies the color *progressbar*, this parameter uses RGB color values
   * ProgressFrameColor -- Specifies the color of the frame at *progressbar*, this parameter uses an RGB color value
   * ProgressPosition -- Determine location *progressbar*, this parameter uses X and Y coordinate values
   * ProgressSize -- Specifies the size of *progressba*, this parameter uses a value of width and height in pixels
2. persona\_list.txt `persona_list.txt` is a configuration file to set how our theme will be displayed. The file contains the following information:

   * Name of Theme Directory
   * Theme Name (also will appear as a tooltip)
   * Location of preview file
   * Location of header file
   * Location of the footer file
   * Backgrond and foreground colors

   Here is an example of the format for writing the information above (for example, a theme named ***rainbow***).

   ```bash
   rainbow;Rainbow;rainbow/preview.png;rainbow/header.png;rainbow/footer.png;;#ffffff;#000000
   ```

After all the assets and configuration files are ready, please run the LO-TC, if the steps are done correctly, your theme should appear as a list of ready-to-use themes.


# Contribute & Disclaimer

### Contributing

Interested in improving the features of this LO-TC? Interested in helping us enrich the collection of themes for LO-TC, please submit a Pull Request to this repository.

### Disclaimer

This tool is still in the development stage so use at your own risk :").

### Project Initiator

This LibreOffice Theme Changer (LO-TC) tool is initiated by:

* [Rania Amina](https://github.com/raniaamina)
* [Sofyan Sugiyanto](https://github.com/artemtech)
* [LibreOffice Indonesia](https://libreoffice.id)


# LOTC-CLI GUIDE (ID)

[EN Version](/libreoffice-theme-changer/libreoffice-theme/lotc-cli-guide-en)

## LibreOffice Theme Changer (LO-TC)

LibreOffice Theme Changer atau LO-TC (baca: Lotis) merupakan sebuah perkakas sederhana untuk membantu Anda mengubah tema pada LibreOffice versi 6.2 atau terbaru. LO-TC memungkinkan Anda untuk mengganti gambar splash dan tema persona pada LibreOffice dengan gambar yang Anda inginkan dengan sangat mudah.


# Memasang Tema

Kami menyediakan beberapa tema yang dapat Anda pilih dan gunakan secara langsung, namun Anda juga dapat menambahkan sendiri tema yang Anda inginkan. Langkah-langkah membuat tema ini akan dibahas pada bagian selanjutnya.

Untuk dapat menjalankan LO-TC, silakan ikuti tahapan-tahapan berikut ini. Pastikan Git sudah terpasang pada sistem operasi Anda.

```bash
$ git clone https://github.com/raniaamina/libreoffice-theme.git
$ cd libreoffice-theme
$ bash install.sh
```

![Memilih Metode Pemasangan](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGe4ZkaS02q7NozG%2Fimg-1.png?generation=1574825652527808\&alt=media)

LibreOffice mendukung banyak metode pemasangan, masing-masing metode memiliki direktori tersendiri untuk menyimpan berkas konfigurasi LibreOffice. Untuk itu, silakan pilih metode pemasangan yang sesuai agar tema dapat dipasang dengan lancar.

Langkah selanjutnya, adalah menentukan tema yang ingin dipasang. Daftar tema yang tersedia dapat dilihat di direktori `themes`.

![Memilih Tema](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGe6MXA6zi_0nC_k%2Fimg-2.png?generation=1574825652549995\&alt=media)

Untuk memasang tema, Anda diharuskan memiliki akses root. Anda akan diminta untuk memasukkan sandi root setelah Anda menentukan tema yang akan dipasang. Selain itu, pastikan pula bahwa aplikasi LibreOffice tidak sedang digunakan/berjalan.

Setelah pemasangan selesai, Anda dapat memlih apakah akan langsung menerapkan tema terpilih atau tidak. Anda dapat mengaktifkan tema secara manual melalui menu `perkakas` --> `Opsi`--> `Personalisasi`. Perhatikan gambar berikut.

![Aktivasi Manual](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGe8xsBNuagCbJ7-%2Fimg-5.png?generation=1574825652416423\&alt=media)

**Catatan khusus**

Untuk saat ini LO-TC dapat berjalan baik pada distribusi Debian, openSUSE, Fedora, Ubuntu, dan distro-dsitro turunannya. Untuk distro-distro selain yang disebutkan harus memasukkan path LibreOffice secara manual. Perhatikan gambar berikut.

![Input Path Secara Manual](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-Luev5LBSYQ-Er4XrmVZ%2F-LubhGeALnG4ZSEHRd3X%2Fimg-6.png?generation=1574825652702462\&alt=media)

### Manghapus Tema LO-TC

Untuk mengahpus tema via LO-TC cukup jalankan perintah

```bash
$ bash uninstall.sh
```

kemudian pilih tema yang ingin dihapus.


# Membuat Tema Sendiri

Berikut langkah-langkah yang dapat Anda ikuti untuk membuat tema kustom LibreOffice.

#### Hirarki Folder Tema

LO-TC menyusun konfigurasi tema dalam sebuah hirarki folder khusus agar mempermudah siapa saja yang ingin membuat kustom tema dan memasangnya menggunakan LO-TC. Simpan dan tempatkan masing-masing aset yang nantinya akan dibuat ke dalam direktori **themes**. LO-TC akan secara otomatis membaca daftar tema yang terdapat pada direktori, kami menyebutnya tema siap pasang.

silakan perhatikan hirarki direktori berikut ini untuk membantu Anda mengetahui di mana lokasi penyimpanan aset-aset yang akan Anda buat pada langkah-langkah selanjutnya.

```bash
themes
└── nama-tema
    ├── program
    │   ├── intro.png
    │   └── sofficerc
    ├── screenshot.png
    └── share
        └── gallery
            └── personas
                ├── nama-tema
                │   ├── footer.png
                │   ├── header.png
                │   └── preview.png
                └── personas_list.txt
```

\[UPDATE] Kami telah menyediakan perkakas tambahan untuk membantu Anda membuat folder tema secara lengkap dan cepat. Cukup jalankan perintah:

```bash
$ bash theme-creator.sh
```

kemudian masukkan nama tema yang Anda inginkan. Secara otomatis LO-TC akan membuat direktori tema sesuai dengan nama yang Anda masukkan ke dalam folder `themes`

#### Menyiapkan Aset-Aset Gambar

Gambar-gambar yang harus dipersiapkan untuk membuat tema ini antara lain:

1. Splash Splash merupakan gambar yang pertama kali muncul ketika Anda menjalankan LibreOffice. Sebenarnya tak ada ukurab baku untuk gambar splash ini, namun kami sarankan untuk menggunakan ukuran yang juga digunakan oleh LibreOffice yaitu 661 x 169 piksel. Anda dapat membuat splash menggunakan template yang sudah kami sediakan. Silakan unduh melalui [tautan ini](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/intro.svg)
2. Header Header merupakan gambar yang tampak pada bagian atas program LibreOffice, tepatnya di area menu LibreOffice. Standar ukuran header ini kami ambil dari standar ukuran aset gambar pada tema-tema persona. Kami sangat menyarankan agar desain yang dibuat untuk header ini memanfaatkan area pojok kanan atas. Alasan teknisnya adalah karena area ini merupakan area palinga aman dan tidak mengganggu visibilitas ikon-ikon pada menu. Kami telah menyiapkan template header yang siap untuk dimodifikasi. Silakan unduh melalui [tautan ini](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/header.svg)
3. Footer Footer merupakan gambar yang akan tampil pada area bawah program LibreOffice. Pada dasarnya footer ini akan tersembunyi secara otomatis apabila tidak ada menu yang terbuka pada bagian bawah/footer LibreOffice. Area aman untuk footer ini berada di sisi kanan, silakan gunakan template yang telah kami sediakan untuk memabantu Anda membuat footer. Template dapat [diunduh di sini](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/footer.svg)
4. Preview Preview merupakan gambar yang akan ditampilkan pada menu `perkakas` --> `Opsi`--> `Personalisasi`. Preview ini menjadi identitas tema Anda. Area aman untuk gambar preview ini berada di bagian tengah are. Silakan untuh template preview yang telah kami sediakan [melalui tautan ini](https://github.com/libreofficeid/LibreOfficeID-Docs/tree/853bc61dbe5602735a5fc6e5321c981647286997/LibreOffice%20Theme/template/preview.svg)
5. Screenshot (opsinal) Bantu para pengguna lain untuk memngenali tema Anda dengan memberikan screenshot ketika tema Anda berhasil terpasang.

#### Membuat Konfigurasi

Setelah Anda menyiapkan aset-aset gambar, sekarang mari menyiapkan berkas-berkas konfogurasi. Berikut adalah beberapa berkas konfigurasi yang akan kita kita siap:

1. sofficerc `sofficerc` merupakan berkas yang akan mengatur bagaimana splash akan ditampilkan. Berikut merupakan isi dari berkas sofficerc dan beberapa penjelasannya.

   ```bash
   [Bootstrap]
   CrashDirectory=${$BRAND_BASE_DIR/program/bootstraprc:UserInstallation}/crash
   HideEula=1
   Logo=1
   NativeProgress=false
   ProgressBarColor=0,0,0
   ProgressFrameColor=102,102,102
   ProgressPosition=35,153
   ProgressSize=444,8
   ProgressTextBaseline=145
   ProgressTextColor=0,0,0
   SecureUserConfig=true
   SecureUserConfigCompress=true
   SecureUserConfigExtensions=true
   SecureUserConfigMode=1
   SecureUserConfigNumCopies=2
   URE_BOOTSTRAP=${ORIGIN}/fundamentalrc
   ```

   untuk melakukan kustomsisasi tampilan Anda hanya perlu menyunting parameter, `logo`, `NativeProgress`, `ProgressBarColor`, `ProgressFrameColor`, `ProgressPosition`, dan `ProgressSize`

   * Logo -- parameter untuk menentukan apakah splash ditampilkan atau tidak
   * NativeProgress -- Menampilkan *progressbar* native atau kustom
   * ProgressBarColor -- Menentukan warna *progressbar*, parameter ini menggunakan nilai warna RGB
   * ProgressFrameColor --  Menentukan warna bingkai pada *progressbar*, parameter ini menggunakan nilai warna RGB
   * ProgressPosition -- Menentukan lokasi *progressbar*, parameter ini menggunakan nilai koordinat X dan Y&#x20;
   * ProgressSize -- Menentukan ukutan dari *progressbar*, parameter ini menggunakan nilai lebar dan tinggi dengan satuan piksel
2. persona\_list.txt `persona_list.txt` merupakan berkas konfigurasi untuk mengatur bagaimana tema kita akan ditampilkan. Berkas terserbut memuat informasi sebagai berikut:

   * Nama Direktori Tema
   * Nama Tema (akan muncul sebagai tooltip)
   * Lokasi berkas preview
   * Lokasi berkas header
   * Lokasi berkas footer
   * Warna backgrond dan foreground

   Berikut merupakan contoh format penulisan informasi di atas (misalnya tema yang dibuat bernama ***rainbow***).

   ```bash
   rainbow;Rainbow;rainbow/preview.png;rainbow/header.png;rainbow/footer.png;;#ffffff;#000000
   ```

Setelah semua aset dan berkas konfigurasi siap, silakan jalankan LO-TC, jika langkah-langkah yang dilakukan benar, seharusnya tema Anda akan muncul sebagai daftar tema yang siap pakai.


# Ikut Terlibat & Sangkalan

### Berkontribusi

Tertarik untuk meningkatkan fitur pada LO-TC ini? Tertarik untuk membantu kami memperkaya koleksi tema untuk LO-TC, silakan ajukan Pull Request pada repositori ini.

### Penyangkalan

Perkakas ini masih dalam tahap pengembangan sehingga pastikan Anda memahami bahwa setiap risiko yang ditimbulkan dari perangkat ini sepenuhnya ditanggung oleh pengguna, hehe.

### Inisiator

Perkakas LibreOffice Theme Changer (LO-TC) ini diinisiasi oleh:

* [Rania Amina](https://github.com/raniaamina)
* [Sofyan Sugiyanto](https://github.com/artemtech)
* [LibreOffice Indonesia](https://libreoffice.id)


# Workflow

LOTC (GUI) Workflow:

* Linux (General) [- Show](/libreoffice-theme-changer/workflow/linux-general)
* Linux (Flatpak) - [Show](/libreoffice-theme-changer/workflow/linux-flatpak)
* Linux (Snap) - [Show](/libreoffice-theme-changer/workflow/linux-snap)
* Mac OSX - [Show](/libreoffice-theme-changer/workflow/mac-osx)
* Windows - [Show](/libreoffice-theme-changer/workflow/windows)


# Linux (General)

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LzrJYqa20yvtyy4iZl_%2F-LzrJsLtxqJb6BG_14qo%2FLINUX%20GENERIC.svg?alt=media\&token=b5555a44-e054-482d-a6db-fcb0f4993b3f)


# Linux (Flatpak)

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LzrJYqa20yvtyy4iZl_%2F-LzrK5vRFbkIE2ZEZCD8%2FLINUX%20FLATPAK.svg?alt=media\&token=15f5529d-e9fc-4cd2-b2d5-98e50e3e5561)


# Linux (Snap)

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LzrJYqa20yvtyy4iZl_%2F-LzrK8Fnk1okhKPRRB9s%2FLINUX%20SNAP.svg?alt=media\&token=6935e226-8625-469a-b80e-2056e7c967da)


# Mac OSX

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LzrJYqa20yvtyy4iZl_%2F-LzrKB0NtA81UUvgYTkx%2FMAC.svg?alt=media\&token=c09e037f-1c83-42ec-acd1-d6f7dd35b8bd)


# Windows

![](https://2209381461-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LubcLYtPD-cSyCT-sCO%2F-LzrJYqa20yvtyy4iZl_%2F-LzrKDDIfOoNHLKbCdkj%2FWINDOWS.svg?alt=media\&token=0990a530-2efc-469a-93d4-e8f228b78f33)


# Lumbung LibreOffice Indonesia

Lumbung LibreOffice Indonesia (Lumbung), merupakan wadah berbagi sumber daya yang berkaitan dengan LibreOffice. Untuk saat ini kami mengelompokkan sumberdaya ini ke dalam tiga kelompok;

* Materi

  Sumberdaya yang berisi panduan, tutorial, modul, atau sejenisnya.
* Templat

  Sumber daya berupa templat yang siap pakai untuk writer, calc, impress, atau yang lain.
* Tema

  Sumber daya berupa tema siap pakai. Kami menyediakan perkakas pembuat dan pengolah tema LibreOffice (khusunya LibreOffice versi 6.2 ke atas) yang dapat diakses melalui [tautan ini](https://github.com/raniaamina/libreoffice-theme).


# Berbagi Sumber Daya

## Berbagi Sumber Daya

Untuk Anda yang ingin membagikan sumber daya ke Lumbung, kami telah menyiapkan beberapa metode pengiriman sumber daya.

* Melalui Pull Request

  Pastikan [Hugo](https://gohugo.io) sudah terpasang di komputer Anda. Selanjutnya fork & clone repositori ini ke akun Github Anda. Kemudian jalankan salah satu perintah berikut.

```bash
# Jika hendak menambah konten materi:
hugo new --kind materi 'materi/Judul Materi'

# Jika hendak menambah konten template:
hugo new --kind template 'templat/Judul Template'

# Jika hendak menambah konten tema:
hugo new --kind tema 'tema/Judul Tema'
```

Langkah selanjutnya adalah melengkapi data konten yang akan ditambahkan. Untuk melakukannya, silakan sunting berkas index.md yang terdapat pada direktori `content/materi` misalnya, untuk konten berupa materi.

Jika sudah, silakan buat commit terhadap perubahan Anda, kemudian segera ajukan Pull Request. Pastikan deskripsi commit ditulis dengan ringkas dan jelas.

Sebelum mendorong perubahan, Anda dapat terlebih dahulu meninjau perubahan yang Anda buat dengan menjalankan Hugo.

```bash
hugo server
```

* Melalui Formulir Google

  Untuk Anda yang belum terbiasa menggunakan perintah-perintah git, kami telah menyediakan Google Form untuk membantu Anda mengirimkan konten sumber daya yang hendak dibagikan.

Silakan merujuk pada [tautan ini](https://forms.gle/tkAaCzkDL7o1jb7j6) untuk mulai mengirim berkas Anda.


# Lisensi

## Lisensi

Setiap berkas yang dikirimkan ke Lumbung akan dilisensikan di bawah lisensi [CC by SA 4.0 ](https://creativecommons.org/licenses/by-sa/4.0/deed.id). Apabila Anda tidak berkenan menggunakan lisensi ini, silakan cantumkan jenis lisensi CC lain yang Anda kehendaki pada bagian deskripsi konten.

##


# Bantuan & Lain-Lain

## Bantuan

Apabila Anda mengalami kesulitan dalam pengiriman konten, silakan untuk melapor ke grup [Telegram LibreOffice ID](https://t.me/LibreOfficeID).

## Lain-Lain

Laman Lumbung ini masih akan disempurkan dari waktu ke waktu. Silakan berkabar kepada kami bila Anda memiliki ide atau saran untuk memperbaiki layanan ini melalui Issue Github.


# Penerjemahan LibreOffice ID

Dokumentasi ini berisi berkas/dokumen terkait penerjemahan LibreOffice ke Bahasa Indonesia.

Di dalamnya terdapat :&#x20;

1. Panduan : berisi langkah-langkah yang perlu dilakukan oleh penerjemah sebelum, saat, dan setelah menerjemahkan.
2. Glossarium : merangkum kata-kata hasil terjemahan yang disepakati bersama oleh penerjemah. Kata-kata yang belum memiliki padanan dalam bahasa Indonesia, akan diberi tanda tanya.

{% hint style="info" %}
Laman baru Glosarium LibreOffice ID: <https://glosarium.libreoffice.id/>
{% endhint %}


# Panduan Penerjemahan LibreOffice

## Sebelum Menerjemahkan

* **Baca panduan konten UI dan Help dari LibreOffice**. [Panduan konten UI dan Help LibreOffice](https://wiki.documentfoundation.org/UI_and_Help_files_Content_Guide) memuat informasi penting seperti simbol-simbol dan *variabel* yang **tidak boleh diubah** ketika kita melakukan penerjemahan. Pastikan Anda menyempatkan waktu membacanya agar dapat meminimalisasi kesalahan. &#x20;

  **Saat Menerjemahkan**<br>
* **Pahami dulu keseluruhan kalimat/paragraf sebelum menerjemahkan.** Dengan memahami maksud dan konteks dari kalimat/paragraf yang diterjemahkan, Anda dapat meminimalisasi kesalahan penerjemahan.\
  &#x20;&#x20;
* **Gunakan mesin penerjemah dengan hati-hati.** Menggunakan mesin penerjemah diperbolehkan namun Anda perlu berhati-hati. Mesin penerjemah seringkali tidak mampu mengenali ungkapan-ungkapan khusus dalam Bahasa Inggris. Contohnya, ungkapan *take with a grain of salt* dalam bahasa Inggris akan diterjemahkan menjadi "ambil dengan butiran garam" oleh mesin penerjemah, padahal itu adalah ungkapan yang berarti bahwa kita sebaiknya tidak percaya begitu saja kepada sesuatu. Oleh karena itu, periksa ulang hasil terjemahan mesin penerjemah sebelum menggunakannya.<br>
* **Jangan menerjemahkan kata-demi-kata.** Tata bahasa Bahasa Inggris berbeda dengan Bahasa Indonesia. Oleh karena itu hindari menerjemahkan kata-demi-kata. Sesuaikanlan kalimat dengan gaya Bahasa Indonesia.<br>
* **Rujuk glosarium untuk LibreOffice.** Glosarium yang dibuat dan diperbaharui oleh kawan-kawan penerjemah LibreOffice ini berisi kata-kata atau istilah yang digunakan di LibreOffice beserta padanan katanya dalam Bahasa Indonesia. Untuk memastikan padanan kata yang saat ini digunakan di LibreOffice, Anda dapat merujuk dokumen ini.<br>
* **Rujuk kamus.** Apabila menemui kata yang tidak ada di glosarium atau tidak Anda ketahui artinya atau Anda kurang pasti, sebaiknya Anda periksa arti kata tersebut melalui kamus. Jika kata tersebut tidak ada dalam kamus, tulis kata tersebut menurut cara baca bahasa Indonesia (untuk istilah teknis/khusus, contohnya: hydrochlorothiazide menjadi hidroklorotiazid), atau biarkan kata tersebut dalam bahasa aslinya, namun dicetak miring. Untuk istilah-istilah teknis, Anda juga bisa mencari padanannya di [Glosarium Pusat Bahasa](http://118.98.223.79/glosarium/index.php?gloss_asing=hall\&gloss_indonesia=\&jenis=exact\&Bidang=all\&infocmd=Cari) atau [Kateglo](http://kateglo.com)<br>
* **Selalu rujuk kamus.** Poin ini perlu diulang karena **seringkali kata-kata tertentu** dalam bahasa asing **memiliki lebih dari satu makna**. Contohnya, istilah *measure* dapat menjadi kata kerja yang berarti "mengukur", atau sebagai kata benda yang bermakna "pengukuran", tapi dalam konteks kebijakan dan perundang-undangan istilah ini memiliki makna yang sangat berbeda **tergantung pada konteksnya**, seperti "tindakan pemerintah", "undang-undang", atau "rancangan undang-undang". Sebagai contoh: kalimat the *Senate passed the measure by a 48–30 vote* akan menjadi salah jika diterjemahkan menjadi "Senat menetapkan ukuran dengan perolehan suara 48-30"; penerjemahan yang tepat dalam konteks ini adalah "Senat telah mengesahkan undang-undang ini dengan perolehan suara 48-30." Maka dari itu, **perhatikan konteks** dan **selalu rujuk kamus.** Salah satu kamus daring yang dapat digunakan adalah [Merriam-Webster](https://www.merriam-webster.com/)<br>
* **Periksalah kata yang bersifat homonim.** Misalnya kata *The Golden Ass*, dimana *Ass* sendiri bisa berarti pantat, bisa juga berarti keledai. Pilihlah pemakaian kata yang selaras dengan konteksnya.<br>
* **Bijaklah dalam mencari padanan untuk kata yang tidak bisa diterjemahkan langsung.** Ada kalanya sebuah kata dalam bahasa Inggris dapat dicocokkan dengan padanan bahasa Indonesia-nya. Misalnya *courtier* bisa diterjemahkan menjadi *abdi dalem*. Namun, seringkali suatu istilah memiliki cakupan/artian yang tidak sepenuhnya sama dengan istilah yang seolah bisa menjadi padanan Indonesia-nya, dan dalam hal ini istilah aslinya bisa dipertahankan dan dicetak miring. Contohnya kata *phaeton* tidak seharusnya dicocokkan dengan kata *delman* mengingat adanya perbedaan cakupan makna, walaupun keduanya memang terkesan serupa.<br>
* **Hindari menggunakan kata&#x20;*****di mana*****.** Dalam bahasa Inggris dan bahasa Indo-Eropa lainnya, kata where dapat diganti dengan kata yang, tempat, atau ketika, tergantung konteksnya. Lihat: [Penggunaan "di mana" sebagai penghubung dua klausa](https://id.wikipedia.org/wiki/Wikipedia:Pedoman_ejaan_dan_penulisan_kata#Penggunaan_%22di_mana%22_sebagai_penghubung_dua_klausa).

## **Setelah Menerjemahkan**

* **Periksa lagi.** Semahir apapun kemampuan bahasa asing Anda, kesalahan adalah hal yang lumrah, baik itu kesalahan penerjemahan, penggunaan kata yang terkesan kaku, penggunaan preposisi yang tidak tepat, atau kesalahan ketik. Maka dari itu, bacalah ulang terjemahan yang sudah Anda buat dan bandingkan dengan versi aslinya.
* **Jika Anda menggunakan Pootle, perhatikan bagian&#x20;*****failing check*****, terutama yang&#x20;*****critical*****.** Pootle memiliki fitur pemeriksaan kesalahan pada hasil penerjemahan, seperti spasi ganda, tanda kurung tidak lengkap, kurang tanda baca, dll. Silakan memeriksa bagian tersebut untuk memastikan tidak ada kesalahan. Jika ada, periksa bagian yang salah, dan perbaiki.

{% hint style="info" %}
**Sumber**

Panduan ini mengadopsi artikel [Wikipedia tentang Penerjemahan Artikel](<https://id.wikipedia.org/wiki/Wikipedia:Panduan_dalam_menerjemahkan_artikel. >). Silakan kunjungi alamat tersebut untuk mendapatkan informasi lebih lengkap.
{% endhint %}


# Usulan Kata/Istilah untuk Glosarium

Lengkapi isian pada formulir pengajuan kosa kata (tautan ada di bawah) untuk mengusulkan daftar kata/istilah dalam [Glosarium LibreOffice Indonesia](https://glosarium.libreoffice.id). Sebelum mengajukan usulan kata/istilah, pastikan kata/istilah yang akan Anda tambahkan belum terdapat di Glosarium aktif atau daftar antrean kata/isitilah (lihat di <https://s.id/katasulit>).

{% hint style="info" %}
Untuk mengusulkan kata baru, [klik tautan ini.](https://docs.google.com/forms/d/e/1FAIpQLSd9Rmx-n3IJsexHfX2Uu590UziIAgLUtdrCWnx7R3Bc9ld7XQ/viewform)
{% endhint %}


# Glossarium (Data Legacy)

Glosarium terkini dapat dikses melalui tautan: <https://glosarium.libreoffice.id/>

## A

advanced = lanjut\
&#x20;align = perataan\
&#x20;author = pengarang<br>

## B

bar = bilah

## C

cancel = batal\
&#x20;cell = sel\
&#x20;close = tutup\
&#x20;column = kolom\
&#x20;content = konten\
&#x20;count = hitung\
&#x20;copy = salin (kk), salinan (kb)\
&#x20;**custom** = ubahan (misal : custom color = warna ubahan) --cek\
&#x20;current = saat ini\
&#x20;Case Sensitive = Peka Kapital

## D

default = baku, bawaan\
&#x20;description = deskripsi, keterangan\
&#x20;digital = digital\
&#x20;disable = matikan\
&#x20;disabled = dimatikan\
&#x20;disc = ? --cek\
&#x20;disk = ? --cek\
&#x20;document = dokumen\
&#x20;download = unduh\
&#x20;**driver** = pemacu/penggerak --cek<br>

## E

email = surel\
&#x20;embed = tanamkan\
&#x20;enable = nyalakan\
&#x20;enabled = dinyalakan\
&#x20;error = galat\
&#x20;export = ekspor\
&#x20;extension = ekstensi<br>

## F

field = ruas\
&#x20;file = berkas\
&#x20;footer = kaki\
&#x20;format = format<br>

## G

grid = kisi<br>

## H

home = beranda\
&#x20;header = tajuk<br>

## I

image = citra\
&#x20;import = impor\
&#x20;insert = sisipkan\
&#x20;item = item<br>

## J

## K

## L

library = pustaka\
&#x20;libraries = pustaka<br>

## M

margin = batasan\
&#x20;mean = rerata\
&#x20;mouse = tetikus<br>

## N

null = nol<br>

## O

offline = luring\
&#x20;online = daring\
&#x20;on the fly = dengan cepat\
&#x20;option = opsi, pilihan\
&#x20;output = keluaran\
&#x20;overwrite = menimpa<br>

## P

pause = jeda (kb) menjeda (kk)\
&#x20;**pop up** = ? --cek\
&#x20;preview = pratinjau\
&#x20;printer = pencetak<br>

## Q

## R

range = rentang\
&#x20;recent = terkini\
&#x20;reference = referensi\
&#x20;region = wilayah\
&#x20;remove = hapuskan\
&#x20;restart = mulai ulang\
&#x20;review = tinjau\
&#x20;row = baris<br>

## S

setting = pengaturan\
&#x20;server = server/peladen\
&#x20;shape = bentuk\
&#x20;shortcut = pintasan\
&#x20;slide = salindia\
&#x20;**spreadsheet** = ? --cek<br>

## T

**tab** = ?\
&#x20;template = templat\
&#x20;text = teks\
&#x20;through = lewati\
&#x20;thumbnail = thumbnail\
&#x20;toogle = jungkit\
&#x20;toolbar = bilah alat\
&#x20;tools = perkakas<br>

## U

update = pemutakhiran (kb), mutakhirkan (kk)\
&#x20;upload = unggah\
&#x20;user = pengguna\
&#x20;username = nama pengguna<br>

## V

valid = valid\
&#x20;view = tampilan<br>

## W

**wizard** = wahana pandu / wisaya --cek\
&#x20;worksheet = lembar kerja\
&#x20;wrap = bungkus<br>

## X

## Y

## Z


