.. _calibredb-ms:
.. raw:: html
``calibredb``
===================================================================
.. code-block:: none
calibredb command [options] [arguments]
:command:`calibredb` is the command line interface to the calibre database. It has
several sub-commands, documented below.
:command:`calibredb` can be used to manipulate either a calibre database
specified by path or a calibre :guilabel:`Content server` running either on
the local machine or over the internet. You can start a calibre
:guilabel:`Content server` using either the :command:`calibre-server`
program or in the main calibre program click :guilabel:`Connect/share ->
Start Content server`. Since :command:`calibredb` can make changes to your
calibre libraries, you must setup authentication on the server first. There
are two ways to do that:
* If you plan to connect only to a server running on the same computer,
you can simply use the ``--enable-local-write`` option of the
content server, to allow any program, including calibredb, running on
the local computer to make changes to your calibre data. When running
the server from the main calibre program, this option is in
:guilabel:`Preferences->Sharing over the net->Advanced`.
* If you want to enable access over the internet, then you should setup
user accounts on the server and use the :option:`--username` and :option:`--password`
options to :command:`calibredb` to give it access. You can setup
user authentication for :command:`calibre-server` by using the ``--enable-auth``
option and using ``--manage-users`` to create the user accounts.
If you are running the server from the main calibre program, use
:guilabel:`Preferences->Sharing over the net->Require username/password`.
To connect to a running Content server, pass the URL of the server to the
:option:`--with-library` option, see the documentation of that option for
details and examples.
.. contents::
:local:
PILIHAN SEJAGAT
~~~~~~~~~~~~~~~~~~~
.. option:: --help, -h
tunjuk mesej bantuan ini dan keluar
.. option:: --library-path, --with-library
Laluan ke pustaka calibre. Lalai gunakan laluan tersimpan dalam tetapan. Anda juga boleh sambungkan dengan pelayan Kandungan calibre untuk membuat tindakan terhadap pustaka jauh. Untuk membuatnya gunakan URL dalam bentuk: http://hostname:port/#library_id sebagai contoh, http://localhost:8080/#mylibrary. library_id ialah id pustaka bagi pustaka yang mahu disambungkan dengan pelayan Kandungan. Anda boleh gunakan nilai khas library_id - untuk dapatkan senarai id pustaka yang tersedia dalam pelayan. Untuk perincian bagaimana hendak memasang melalui pelayan Kandungan, sila rujuk https://manual.calibre-ebook.com/ms/generated/ms/calibredb.html.
.. option:: --password
Kata laluan untuk menyambung dengan pelayan Kandungan calibre. Untuk membaca kata laluan dari input piawai, gunakan nilai khas: . Manakala, untuk membaca kata laluan dari fail, guna: (i.e. ). Kurungan seperti di atas diperlukan, ingat kena kurungkan.
.. option:: --username
Nama pengguna untuk menyambung dengan pelayan Kandungan calibre
.. option:: --version
tunjuk nombor versi program dan keluar
.. _calibredb-ms-list:
list
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb list [options]
Senaraikan buku tersedia dalam pangkalan data calibre.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb list
.. option:: --ascending
Isih keputusan dalam tertib menaik
.. option:: --fields, -f
Medan yang dipaparkan bila menyenaraikan buku dalam pangkalan data. Seharusnya senarai medan dipisah-tanda-koma. Medan tersedia: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, timestamp, title, uuid Lalai: % lalai. Medan khas \ ``"``\ all\ ``"``\ boleh digunakan untuk pilih semua medan. Selain dari medan terbina-dalam seperti di atas, medan suai juga tersedia seperti \*field_name, sebagai contoh, untuk medan suai #rating, gunakan nama: \*rating
.. option:: --for-machine
Jalan output dalam format JSON, yang lebih sesuai untuk penghuraian mesin. Menyebabkan lebar garisan dan pilihan pemisah diabaikan.
.. option:: --limit
Bilangan keputusan makismum untuk dipaparkan. Lalai: semua
.. option:: --line-width, -w
Lebar maksimum baris tunggal dalam output. Lalai ialah mengesan saiz skrin.
.. option:: --prefix
Awalan untuk semua laluan fail. Lalai ialah laluan mutlak ke folder pustaka.
.. option:: --search, -s
Tapis keputusan dengan pertanyaan gelintar. Bagi format pertanyaan gelintar, sila rujuk dokumentasi berkaitan gelintar dalam Panduan Pengguna. Lalai adalah tidak membuat penapisan.
.. option:: --separator
Rentetan yang digunakan untuk memisahkan medan. Lalai ialah jarak.
.. option:: --sort-by
Medan yang mana mengisih keputusan. Medan tersedia: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, timestamp, title, uuid Lalai: id
.. _calibredb-ms-add:
add
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb add [options] fail1 fail2 fail3 ...
Tambah fail dinyatakan sebagai buku ke pangkalan data. Anda juga boleh nyatakan
direktori, sila rujuk pilihan berkenaan direktori di bawah.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb add
.. option:: --authors, -a
Tetapkan pengarang buku yang ditambah
.. option:: --automerge, -m
If books with similar titles and authors are found, merge the incoming formats (files) automatically into existing book records. A value of \ ``"``\ ignore\ ``"``\ means duplicate formats are discarded. A value of \ ``"``\ overwrite\ ``"``\ means duplicate formats in the library are overwritten with the newly added files. A value of \ ``"``\ new_record\ ``"``\ means duplicate formats are placed into a new book record.
.. option:: --cover, -c
Laluan ke kulit buku digunakan untuk buku yang ditambah
.. option:: --duplicates, -d
Add books to database even if they already exist. Comparison is done based on book titles and authors. Note that the :option:`--automerge` option takes precedence.
.. option:: --empty, -e
Tambah buku kosong (buku tanpa format)
.. option:: --identifier, -I
Tetapkan pengecam unutk buku ini, contohnya -I asin:XXX -I isbn:YYY
.. option:: --isbn, -i
Tetapkan ISBN buku yang ditambah
.. option:: --languages, -l
Senarai dipisah tanda koma bahasa (terbaik gunakan kod bahasa ISO639, walaupun sesetengah nama bahasa juga dikenalpasti)
.. option:: --series, -s
Tetapkan siri bagi buku yang ditambah
.. option:: --series-index, -S
Tetapkan nombor siri bagi buku yang ditambah
.. option:: --tags, -T
Tetapkan tag bagi buku yang ditambah
.. option:: --title, -t
Tetapkan tajuk buku yang ditambah
DITAMBAH DARI DIREKTORI
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Pilihan untuk mengawal penambahan buku dari direktori. Secara lalai hanya fail yang mempunyai sambungan jenis fail e-buku yang diketahui boleh ditambah.
.. option:: --add
Satu pola (glob) nama fail, fail yang sepadan dengan pola ini akan diabaikan bila mengimbas direktori untuk dapatkan fail, walaupun jika ia bukanlah jenis fail e-buku yang dikenali. Boleh dinyatakan lebih dari sekali untuk pola berbilang.
.. option:: --ignore
Satu pola (glob) nama fail, fail yang sepadan dengan pola ini akan diabaikan bila mengimbas direktori untuk dapatkan fail. Boleh dinyatakan lebih dari sekali untuk pola berbilang. Sebagai contoh: \*.pdf akan abaikan semua fail pdf
.. option:: --one-book-per-directory, -1
Anggap setiap direktori hanya mempunyai satu buku logikal dan semua fail berada di dalamnya adalah format ebuku yang berlainan bagi buku tersebut
.. option:: --recurse, -r
Proses direktori secara rekursif
.. _calibredb-ms-remove:
remove
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb remove ids
Buang buku yang dikenalpasti dengan id dari pangkalan data. id seharusnya senarai terpisah-tanda-koma nombor id (anda boleh dapatkan nombor id dengan menggunakan perintah gelintar). Sebagai contoh, 23,34,57-85 (bila menyatakan julat, nombor terakhir dalam julat tidak disertakan).
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb remove
.. option:: --permanent
Jangan guna tong sampah kitar semula
.. _calibredb-ms-add_format:
add_format
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb add_format [options] id fail_ebuku
Tambah e-buku dalam fail_ebuku kepada format tersedia untuk buku logikal yang dkenalpasti dengan id. Anda boleh dapatkan id menerusi perintah gelintar. Jika format sudah wujud, ia akan digantikan, melainkan pilihan tidak ganti dinyatakan.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb add_format
.. option:: --dont-replace
Jangan ganti format jika ia sudah wujud
.. _calibredb-ms-remove_format:
remove_format
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb remove_format [options] id fmt
Buang format fmt dari buku logikal yang dikenalpasti dengan id. Anda boleh dapatkan id menerusi perintah gelintar. fmt seharusnya sambungan fail seperti LRF atau TXT atau EPUB. Jika buku logikal tidak mempunyai fmt, jangan buat apa-apa.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb remove_format
.. _calibredb-ms-show_metadata:
show_metadata
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb show_metadata [options] id
Tunjuk data meta yang tersimpan dalam pangkalan data calibre bagi buku
yang dikenalpasti oleh id.
id ialah nombor id dari perintah gelintar.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb show_metadata
.. option:: --as-opf
Cetak data meta dalam bentuk OPF (XML)
.. _calibredb-ms-set_metadata:
set_metadata
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb set_metadata [options] id [/laluan/ke/metadata.opf]
Tetapan data meta yang tersimpan dalam pangkalan data calibre bagi buku
yang dikenalpasti dengan id dari fail OPF metadata.opf. id ialah nombor id
dari perintah gelintar. Anda boleh dapatkan format OPF dengan menggunakan
--as-opf yang ditukar ke perintah show_metadata. Anda juga boleh tetapkan
data meta bagi medan secara individu dengan pilihan --field. Jika anda guna
pilihan --field, tidak perlu nyatakan fail OPF.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb set_metadata
.. option:: --field, -f
Medan yang ditetapkan. Format ialah field_name:value, contohnya: :option:`--field` tags:tag1,tag2. Guna :option:`--list-fields` untuk dapatkansenarai bagi semua nama medan. Anda boleh nyatakan pilihan ini berbilang kali untuk tetapkan medan berbilang. Perhatian: Bagi bahasa anda mesti guna kod bahasa ISO639 (contohnya en untuk bahasa Inggeris, ms untuk Bahasa Melayu dan sebagainya). Bagi pengecam, sintaks ialah :option:`--field` identifiers:isbn:XXXX,doi:YYYYY. Bagi medan boolean (yes/no) gunakan true dan false atau yes dan no.
.. option:: --list-fields, -l
Senarai nama medan data meta yang boleh digunakan dengan pilihan :option:`--field`
.. _calibredb-ms-export:
export
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb export [options] ids
Eksport buku yang dinyatakan dengan id (senarai dipisah-tanda-koma) ke
sistem fail. Operasi eksport simpan semua format buku, kulit bukunya dan
data meta (dalam fail opf). Anda boleh dapatan nombor id melalui
perintah gelintar.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb export
.. option:: --all
Eksport semua buku dalam pangkalan data, mengabaikan senarai id.
.. option:: --dont-asciiize
Have calibre convert all non English characters into English equivalents for the file names. This is useful if saving to a legacy filesystem without full support for Unicode filenames. Menyatakan suis ini akan matikan kelakuan ini.
.. option:: --dont-save-cover
Biasanya, calibre akan simpan kulit buku dalam fail berasingan bersama-sama dengan fail ebuku yang sebenarnya. Menyatakan suis ini akan matikan kelakuan ini.
.. option:: --dont-update-metadata
Biasanya, calibre akan mengemaskini data meta dalam fail tersimpan dari pustaka calibre. Menjadikan proses penyimpanan ke dalam cakera lebih lambat. Menyatakan suis ini akan matikan kelakuan ini.
.. option:: --dont-write-opf
Biasanya, calibre akan tulis data meta ke dalam fail OPS secara berasingan bersama-sama dengan fail ebuku yang sebenarnya. Menyatakan suis ini akan matikan kelakuan ini.
.. option:: --formats
Senarai format dipisah-koma untuk simpan setiap buku. Secara lalai semua format yang tersedia disimpan.
.. option:: --progress
Kemajuan laporan
.. option:: --replace-whitespace
Ganti ruang putih dengan underscore.
.. option:: --single-dir
Eksport semua buku ke dalam satu direktori
.. option:: --template
Templat yang mengawal nama fail dan struktur fail tersimpan. Lalai ialah \ ``"``\ {author_sort}/{title}/{title} - {authors}\ ``"``\ yang akan menyimpan buku ke dalam sub-direktori per-pengarang dengan nama fail yang mengandungi tajuk dan pengarang. Kawalan yang tersedia adalah: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title}
.. option:: --timefmt
Format yang memaparkan tarikh. %d - hari, %b - bulan, %m - nombor bulan, %Y - tahun. Lalai ialah: %b, %Y
.. option:: --to-dir
Eksport buku ke direktori yang dinyatakan, Lalai ialah .
.. option:: --to-lowercase
Tukar laluan menjadi huruf kecil.
.. _calibredb-ms-catalog:
catalog
~~~~~~~~~~~~~~~~~~~~
.. code-block:: none
calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options]
Export a :command:`catalog` in format specified by path/to/destination extension.
Options control how entries are displayed in the generated :command:`catalog` output.
Note that different :command:`catalog` formats support different sets of options. To
see the different options, specify the name of the output file and then the
--help option.
Whenever you pass arguments to calibredb that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"
.. program:: calibredb catalog
.. option:: --ids, -i
Senarai terpisah-koma bagi ID pangkalan data ke katalog. Jika diisytihar, :option:`--search` diabaikan. Lalai: all
.. option:: --search, -s
Tapis keputusan dengan pertanyaan gelintar. Bagi format pertanyaan gelintar, sila rujuk dokumentasi berkaitan gelintar dalam Panduan Pengguna. Lalai: tanpa penapisan
.. option:: --verbose, -v
Tunjuk maklumat output terperinci. Berguna untuk penyahpepijatan
EPUB PILIHAN
^^^^^^^^^^^^^^^^
.. option:: --catalog-title
Tajuk katalog terjana yang digunakan sebagai tajuk dalam data meta. Lalai: \ ``'``\ My Books\ ``'``\ Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --cross-reference-authors
Cipta rujukan-silang pada seksyen Pengarang bagi buku dengan pengarang berbilang. Lalai: \ ``'``\ False\ ``'``\ Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --debug-pipeline
Simpan output dari tahap berlainan bagi penukaran talian paip ke direktori yang dinyatakan. Berguna jika anda tidak pasti pada tahap manakah proses penukaran yang mana berlakunya pepijat. Lalai: \ ``'``\ None\ ``'``\ Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --exclude-genre
Ungkapan nalar menjelaskan tag untuk diasing sebagai genre. Lalai: \ ``'``\ \[.+\]|^\+$\ ``'``\ asingkan tag terkurung, seperti \ ``'``\ [Project Gutenberg]\ ``'``\ , dan \ ``'``\ +\ ``'``\ , tag lalai untuk baca buku. Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --exclusion-rules
Nyatakan peraturan yang digunakan untuk asingkan buku dari katalog terjana. Model peraturan pengecualian adalah sama ada (\ ``'``\ \ ``'``\ ,\ ``'``\ Tags\ ``'``\ ,\ ``'``\ \ ``'``\ ) atau (\ ``'``\ \ ``'``\ ,\ ``'``\ \ ``'``\ ,\ ``'``\ \ ``'``\ ). Contohnya: ((\ ``'``\ Archived books\ ``'``\ ,\ ``'``\ #status\ ``'``\ ,\ ``'``\ Archived\ ``'``\ ),) akan asingkan buku dengan nilai \ ``'``\ Archived\ ``'``\ dalam lajur suai \ ``'``\ status\ ``'``\ . Bila peraturan berbilang ditakrif, semua peraturan akan dilaksanakan. Lalai: \ ``"``\ ((\ ``'``\ Catalogs\ ``'``\ ,\ ``'``\ Tags\ ``'``\ ,\ ``'``\ Catalog\ ``'``\ ),)\ ``"``\ Dilaksana pada format output AZW3, EPUB, MOBI
.. option:: --generate-authors
Sertakan seksyen \ ``'``\ Pengarang\ ``'``\ dalam katalog. Lalai: \ ``'``\ False\ ``'``\ Dilaksanakan pada: format output AZW3, EPUB, MOBI
.. option:: --generate-descriptions
Sertakan seksyen \ ``'``\ Keterangan\ ``'``\ dalam katalog. Lalai: \ ``'``\ False\ ``'``\ Dilaksanakan pada: format output AZW3, EPUB, MOBI
.. option:: --generate-genres
Sertakan seksyen \ ``'``\ Genre\ ``'``\ dalam katalog. Lalai: \ ``'``\ False\ ``'``\ Dilaksanakan pada: format output AZW3, EPUB, MOBI
.. option:: --generate-recently-added
Sertakan seksyen \ ``'``\ Ditambah Baru-Baru Ini\ ``'``\ dalam katalog. Lalai: \ ``'``\ False\ ``'``\ Dilaksanakan pada: format output AZW3, EPUB, MOBI
.. option:: --generate-series
Sertakan seksyen \ ``'``\ Siri\ ``'``\ dalam katalog. Lalai: \ ``'``\ False\ ``'``\ Dilaksanakan pada: format output AZW3, EPUB, MOBI
.. option:: --generate-titles
Sertakan seksyen \ ``'``\ Tajuk\ ``'``\ dalam katalog. Lalai: \ ``'``\ False\ ``'``\ Dilaksanakan pada: format output AZW3, EPUB, MOBI
.. option:: --genre-source-field
Medan sumber untuk seksyen \ ``'``\ Genre\ ``'``\ . Lalai: \ ``'``\ Tag\ ``'``\ Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --header-note-source-field
Medan suai mengandungi teks nota untuk disisip dalam Pengepala Keterangan. Lalai: \ ``'``\ \ ``'``\ Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --merge-comments-rule
#:[before|after]:[True|False] specifying: Custom field containing notes to merge with comments [before|after] Placement of notes with respect to comments [True|False] - A horizontal rule is inserted between notes and comments Default: \ ``'``\ ::\ ``'``\ Applies to: AZW3, EPUB, MOBI output formats
.. option:: --output-profile
Nyatakan profil output. Dalam sesetengah kes, satu profil output diperlukan untuk optimumkan katalog bagi peranti. Contohnya, \ ``'``\ kindle\ ``'``\ atau \ ``'``\ kindle_dx\ ``'``\ hasilkan Senarai Kandungan berstrukutr dengan Seksyen dan Artikel. Lalai: \ ``'``\ None\ ``'``\ Dilaksana pada: format output AZW3, EPUB, MOBI
.. option:: --prefix-rules
Nyatakan peraturan yang digunakan untuk disertakan awalan yang menunjukkan buku telah dibaca, item senarai idaman dan lain-lain awalan khusus-pengguna. Model untuk peraturan awalan ialah (\ ``'``\ \ ``'``\ ,\ ``'``\