From e38d2351b83fa65c66ccde443777647ef5cb6cff Mon Sep 17 00:00:00 2001 From: tpearson Date: Mon, 1 Mar 2010 19:17:32 +0000 Subject: Added KDE3 version of Tellico git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/tellico@1097620 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/CMakeLists.txt | 4 + doc/Makefile.am | 5 + doc/en/CMakeLists.txt | 62 +++ doc/en/Makefile.am | 50 +++ doc/en/advanced.docbook | 151 +++++++ doc/en/amazon-options.png | Bin 0 -> 36487 bytes doc/en/configuration.docbook | 376 +++++++++++++++++ doc/en/csv-dialog.png | Bin 0 -> 41376 bytes doc/en/details.docbook | 547 ++++++++++++++++++++++++ doc/en/entry-editor1.png | Bin 0 -> 26001 bytes doc/en/entry-editor3.png | Bin 0 -> 23827 bytes doc/en/entry-editor4.png | Bin 0 -> 20807 bytes doc/en/entry-editor5.png | Bin 0 -> 25436 bytes doc/en/export-bibtex.png | Bin 0 -> 9404 bytes doc/en/export-csv.png | Bin 0 -> 6259 bytes doc/en/export-html.png | Bin 0 -> 4973 bytes doc/en/export-options.png | Bin 0 -> 7411 bytes doc/en/export-pdb.png | Bin 0 -> 3742 bytes doc/en/externalexec-options.png | Bin 0 -> 47693 bytes doc/en/faqs.docbook | 257 ++++++++++++ doc/en/fetch-dialog.png | Bin 0 -> 110344 bytes doc/en/fields-dialog.png | Bin 0 -> 59595 bytes doc/en/filter-dialog.png | Bin 0 -> 28523 bytes doc/en/filter-view.png | Bin 0 -> 9865 bytes doc/en/freebsd-doc-license.html | 57 +++ doc/en/fundamentals.docbook | 595 ++++++++++++++++++++++++++ doc/en/general-options.png | Bin 0 -> 43921 bytes doc/en/hacking.docbook | 362 ++++++++++++++++ doc/en/imdb-options.png | Bin 0 -> 37132 bytes doc/en/importing-exporting.docbook | 452 ++++++++++++++++++++ doc/en/index.docbook | 423 +++++++++++++++++++ doc/en/loan-dialog.png | Bin 0 -> 32261 bytes doc/en/loan-view.png | Bin 0 -> 8383 bytes doc/en/main-window.png | Bin 0 -> 296455 bytes doc/en/menus.docbook | 768 +++++++++++++++++++++++++++++++++ doc/en/openoffice-dialog.png | Bin 0 -> 29340 bytes doc/en/print-options.png | Bin 0 -> 41140 bytes doc/en/report-dialog.png | Bin 0 -> 125817 bytes doc/en/source-options.png | Bin 0 -> 64944 bytes doc/en/sru-options.png | Bin 0 -> 33399 bytes doc/en/template-options.png | Bin 0 -> 52477 bytes doc/en/z3950-options.png | Bin 0 -> 46578 bytes doc/fr/CMakeLists.txt | 60 +++ doc/fr/Makefile.am | 50 +++ doc/fr/advanced.docbook | 120 ++++++ doc/fr/amazon-options.png | Bin 0 -> 25139 bytes doc/fr/configuration.docbook | 445 ++++++++++++++++++++ doc/fr/csv-dialog.png | Bin 0 -> 44655 bytes doc/fr/details.docbook | 613 +++++++++++++++++++++++++++ doc/fr/entry-editor1.png | Bin 0 -> 18682 bytes doc/fr/entry-editor3.png | Bin 0 -> 17142 bytes doc/fr/entry-editor4.png | Bin 0 -> 13710 bytes doc/fr/entry-editor5.png | Bin 0 -> 21396 bytes doc/fr/export-bibtex.png | Bin 0 -> 9322 bytes doc/fr/export-csv.png | Bin 0 -> 6859 bytes doc/fr/export-html.png | Bin 0 -> 5455 bytes doc/fr/export-options.png | Bin 0 -> 9052 bytes doc/fr/export-pdb.png | Bin 0 -> 3809 bytes doc/fr/externalexec-options.png | Bin 0 -> 32785 bytes doc/fr/faqs.docbook | 279 ++++++++++++ doc/fr/fetch-dialog.png | Bin 0 -> 58858 bytes doc/fr/fields-dialog.png | Bin 0 -> 51344 bytes doc/fr/filter-dialog.png | Bin 0 -> 18958 bytes doc/fr/filter-view.png | Bin 0 -> 6325 bytes doc/fr/freebsd-doc-license.html | 57 +++ doc/fr/fundamentals.docbook | 841 +++++++++++++++++++++++++++++++++++++ doc/fr/general-options.png | Bin 0 -> 37318 bytes doc/fr/hacking.docbook | 448 ++++++++++++++++++++ doc/fr/imdb-options.png | Bin 0 -> 28569 bytes doc/fr/importing-exporting.docbook | 594 ++++++++++++++++++++++++++ doc/fr/index.docbook | 452 ++++++++++++++++++++ doc/fr/loan-dialog.png | Bin 0 -> 25629 bytes doc/fr/loan-view.png | Bin 0 -> 6034 bytes doc/fr/main-window.png | Bin 0 -> 110844 bytes doc/fr/menus.docbook | 821 ++++++++++++++++++++++++++++++++++++ doc/fr/openoffice-dialog.png | Bin 0 -> 20695 bytes doc/fr/print-options.png | Bin 0 -> 32049 bytes doc/fr/report-dialog.png | Bin 0 -> 55663 bytes doc/fr/source-options.png | Bin 0 -> 32748 bytes doc/fr/sru-options.png | Bin 0 -> 23757 bytes doc/fr/template-options.png | Bin 0 -> 46891 bytes doc/fr/z3950-options.png | Bin 0 -> 30819 bytes 82 files changed, 8889 insertions(+) create mode 100644 doc/CMakeLists.txt create mode 100644 doc/Makefile.am create mode 100644 doc/en/CMakeLists.txt create mode 100644 doc/en/Makefile.am create mode 100644 doc/en/advanced.docbook create mode 100644 doc/en/amazon-options.png create mode 100644 doc/en/configuration.docbook create mode 100644 doc/en/csv-dialog.png create mode 100644 doc/en/details.docbook create mode 100644 doc/en/entry-editor1.png create mode 100644 doc/en/entry-editor3.png create mode 100644 doc/en/entry-editor4.png create mode 100644 doc/en/entry-editor5.png create mode 100644 doc/en/export-bibtex.png create mode 100644 doc/en/export-csv.png create mode 100644 doc/en/export-html.png create mode 100644 doc/en/export-options.png create mode 100644 doc/en/export-pdb.png create mode 100644 doc/en/externalexec-options.png create mode 100644 doc/en/faqs.docbook create mode 100644 doc/en/fetch-dialog.png create mode 100644 doc/en/fields-dialog.png create mode 100644 doc/en/filter-dialog.png create mode 100644 doc/en/filter-view.png create mode 100644 doc/en/freebsd-doc-license.html create mode 100644 doc/en/fundamentals.docbook create mode 100644 doc/en/general-options.png create mode 100644 doc/en/hacking.docbook create mode 100644 doc/en/imdb-options.png create mode 100644 doc/en/importing-exporting.docbook create mode 100644 doc/en/index.docbook create mode 100644 doc/en/loan-dialog.png create mode 100644 doc/en/loan-view.png create mode 100644 doc/en/main-window.png create mode 100644 doc/en/menus.docbook create mode 100644 doc/en/openoffice-dialog.png create mode 100644 doc/en/print-options.png create mode 100644 doc/en/report-dialog.png create mode 100644 doc/en/source-options.png create mode 100644 doc/en/sru-options.png create mode 100644 doc/en/template-options.png create mode 100644 doc/en/z3950-options.png create mode 100644 doc/fr/CMakeLists.txt create mode 100644 doc/fr/Makefile.am create mode 100644 doc/fr/advanced.docbook create mode 100644 doc/fr/amazon-options.png create mode 100644 doc/fr/configuration.docbook create mode 100644 doc/fr/csv-dialog.png create mode 100644 doc/fr/details.docbook create mode 100644 doc/fr/entry-editor1.png create mode 100644 doc/fr/entry-editor3.png create mode 100644 doc/fr/entry-editor4.png create mode 100644 doc/fr/entry-editor5.png create mode 100644 doc/fr/export-bibtex.png create mode 100644 doc/fr/export-csv.png create mode 100644 doc/fr/export-html.png create mode 100644 doc/fr/export-options.png create mode 100644 doc/fr/export-pdb.png create mode 100644 doc/fr/externalexec-options.png create mode 100644 doc/fr/faqs.docbook create mode 100644 doc/fr/fetch-dialog.png create mode 100644 doc/fr/fields-dialog.png create mode 100644 doc/fr/filter-dialog.png create mode 100644 doc/fr/filter-view.png create mode 100644 doc/fr/freebsd-doc-license.html create mode 100644 doc/fr/fundamentals.docbook create mode 100644 doc/fr/general-options.png create mode 100644 doc/fr/hacking.docbook create mode 100644 doc/fr/imdb-options.png create mode 100644 doc/fr/importing-exporting.docbook create mode 100644 doc/fr/index.docbook create mode 100644 doc/fr/loan-dialog.png create mode 100644 doc/fr/loan-view.png create mode 100644 doc/fr/main-window.png create mode 100644 doc/fr/menus.docbook create mode 100644 doc/fr/openoffice-dialog.png create mode 100644 doc/fr/print-options.png create mode 100644 doc/fr/report-dialog.png create mode 100644 doc/fr/source-options.png create mode 100644 doc/fr/sru-options.png create mode 100644 doc/fr/template-options.png create mode 100644 doc/fr/z3950-options.png (limited to 'doc') diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt new file mode 100644 index 0000000..53715b4 --- /dev/null +++ b/doc/CMakeLists.txt @@ -0,0 +1,4 @@ +ADD_SUBDIRECTORY( en ) +ADD_SUBDIRECTORY( fr ) + + diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..88b7aa7 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,5 @@ +####### kdevelop will overwrite this part!!! (begin)########## + +SUBDIRS = en fr + +####### kdevelop will overwrite this part!!! (end)############ diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt new file mode 100644 index 0000000..5cfedb9 --- /dev/null +++ b/doc/en/CMakeLists.txt @@ -0,0 +1,62 @@ + +KDE_CREATE_HANDBOOK( index.docbook Xi + INSTALL_DESTINATION share/doc/kde/HTML/en/tellico + ) + +########### install files ############### + + + + +#original Makefile.am contents follow: + +######## kdevelop will overwrite this part!!! (begin)########## +# +# +#EXTRA_DIST = \ +#advanced.docbook \ +#configuration.docbook \ +#details.docbook \ +#faqs.docbook \ +#fundamentals.docbook \ +#hacking.docbook \ +#importing-exporting.docbook \ +#index.docbook \ +#menus.docbook \ +#freebsd-doc-license.html \ +#entry-editor1.png \ +#entry-editor3.png \ +#entry-editor4.png \ +#entry-editor5.png \ +#fields-dialog.png \ +#general-options.png \ +#main-window.png \ +#print-options.png \ +#template-options.png \ +#source-options.png \ +#filter-dialog.png \ +#csv-dialog.png \ +#fetch-dialog.png \ +#export-options.png \ +#export-html.png \ +#export-csv.png \ +#export-pdb.png \ +#export-bibtex.png \ +#amazon-options.png \ +#z3950-options.png \ +#externalexec-options.png \ +#report-dialog.png \ +#loan-dialog.png \ +#loan-view.png \ +#filter-view.png \ +#openoffice-dialog.png \ +#sru-options.png \ +#imdb-options.png +# +# +######## kdevelop will overwrite this part!!! (end)############ +# +#KDE_LANG = en +#KDE_DOCS = tellico +# +#CLEANFILES = *~ diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 0000000..adc1d6f --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,50 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +EXTRA_DIST = \ +advanced.docbook \ +configuration.docbook \ +details.docbook \ +faqs.docbook \ +fundamentals.docbook \ +hacking.docbook \ +importing-exporting.docbook \ +index.docbook \ +menus.docbook \ +freebsd-doc-license.html \ +entry-editor1.png \ +entry-editor3.png \ +entry-editor4.png \ +entry-editor5.png \ +fields-dialog.png \ +general-options.png \ +main-window.png \ +print-options.png \ +template-options.png \ +source-options.png \ +filter-dialog.png \ +csv-dialog.png \ +fetch-dialog.png \ +export-options.png \ +export-html.png \ +export-csv.png \ +export-pdb.png \ +export-bibtex.png \ +amazon-options.png \ +z3950-options.png \ +externalexec-options.png \ +report-dialog.png \ +loan-dialog.png \ +loan-view.png \ +filter-view.png \ +openoffice-dialog.png \ +sru-options.png \ +imdb-options.png + + +####### kdevelop will overwrite this part!!! (end)############ + +KDE_LANG = en +KDE_DOCS = tellico + +CLEANFILES = *~ diff --git a/doc/en/advanced.docbook b/doc/en/advanced.docbook new file mode 100644 index 0000000..61286ed --- /dev/null +++ b/doc/en/advanced.docbook @@ -0,0 +1,151 @@ + +Advanced Usage + + +Command Line Options + + +When running &appname; from the command line, there are several options for opening data files. They may be seen by running tellico --help. + + + +Usage: tellico [Qt-options] [KDE-options] [options] [filename] + +Tellico - a collection manager for KDE + +Options: + --nofile Do not reopen the last open file + --bibtex Import <filename> as a bibtex file + --mods Import <filename> as a MODS file + --ris Import <filename> as a RIS file + +Arguments: + filename File to open + + + + + +&DCOP; Interface + + +&appname; has a minimal &DCOP; interface, which can be used for scripting or interacting with a running application from the command-line. As with all &DCOP; calls, you need to specify the application you want to interface with, and the particular interface. The name of the &DCOP; application is tellico-<pid>, where <pid> is the process id of the running application. + + + +DCOP Commands + +Two &DCOP; objects are available in the tellico interface: tellico and collection. + + +The <constant>tellico</constant> Object + +The full list of &DCOP; commands in the tellico object is shown below: + + +bool importTellico(QString file, QString action) +bool importBibtex(QString file, QString action) +bool importMODS(QString file, QString action) +bool importRIS(QString file, QString action) +bool exportXML(QString file) +bool exportZip(QString file) +bool exportBibtex(QString file) +bool exportHTML(QString file) +bool exportCSV(QString file) +bool exportPilotDB(QString file) +QValueList<long int> selectedEntries() +QValueList<long int> filteredEntries() +void openFile(QString file) +void setFilter(QString text) +bool showEntry(long int id) + + + +For the four import commands, the first argument is the file to import, and the second is the import action. Three actions are available: replace, append, and merge. Four file formats are supported for importing: Tellico XML files, Bibtex files, MODS files, and RIS files. + + + +The current open collection in &appname; may be exported to a file, in either Tellico XML format, Tellico ZIP format, Bibtex, HTML, comma-separated values (CSV), or the PilotDB format. + + +A list of the entry IDs currently selected or being filtered is able to facilitate showing or updating entries in the view. + + A new data file may be opened by using the openFile() command. The full path must be specified. + +A new filter may be set using the setFilter() command, which is the equivalent of typing in the filter box in the main window. + +Given an entry ID, showEntry() will select that entry and show the entry details in the main window. + + + +The <constant>collection</constant> Object + +The full list of &DCOP; commands in the collection object is shown below: + + +long int addEntry() +bool removeEntry(long int entryID) +QStringList values(QString fieldName) +QStringList values(long int entryID,QString fieldName) +QStringList bibtexKeys() +QString bibtexKey(long int entryID) +bool setFieldValue(long int entryID,QString fieldName,QString value) +bool addFieldValue(long int entryID,QString fieldName,QString value) + + + +A new empty entry may be created in the current collection using the addEntry() command. The return value is the entry ID, which can then be used to set the field values in the entry. An entry can be deleted from the collection by calling removeEntry(). + + + +Calling values() using just a field name will return all the values for that field for the currently selected entries. If no entries are selected, the return list is empty. If an entry ID is included in the command, the field values for that specific entry are returned. + + + +If the current collection is a bibliography, calling bibtexKeys() will return the Bibtex citation key for all selected entries. The bibtexKey for a specific entry may be found by using the bibtekKey() command. + + + +Entries can be edited directly with the &DCOP; interface. Given an entry ID, setFieldValue() will set the field value directly. To add a value, without affecting the existing values, use addFieldValue(). The new value gets appended to the end of the existing list. + + + + + + +DCOP Examples + + +Here are some examples for scripting &appname; using the &DCOP; interface. Since the pid must be known, the easiest way to include that in the shell command is like so: dcop $(dcop | grep tellico) tellico. + + + +Open a Bibtex file +% dcop $(dcop | grep tellico) tellico importBibtex ~/documents/reference.bib replace +true + + + +Export a Bibtex file +% dcop $(dcop | grep tellico) tellico exportBibtex ~/documents/reference.bib +true + + + +Echo the citation key of the current selection +% dcop $(dcop | grep tellico) collection bibtexKeys +stephenson2004 + + + +Add a new entry and set the title +% myid=`dcop $(dcop | grep tellico) collection addEntry` +% dcop $(dcop | grep tellico) collection setFieldValue $myid title "My New Book" +true + + + + + + + diff --git a/doc/en/amazon-options.png b/doc/en/amazon-options.png new file mode 100644 index 0000000..549d122 Binary files /dev/null and b/doc/en/amazon-options.png differ diff --git a/doc/en/configuration.docbook b/doc/en/configuration.docbook new file mode 100644 index 0000000..3b7a617 --- /dev/null +++ b/doc/en/configuration.docbook @@ -0,0 +1,376 @@ + +Configuration + + + +The Configuration Dialog contains all the options for +changing some of the default behaviour of &appname;. + + + +Clicking the Apply button causes the changes to +take effect immediately without closing the dialog, while +OK applies the changes and closes the dialog. Cancel closes the dialog, but any changes already made +and applied will remain. The Default button reverts +the options on the current page of the dialog to their default values, +while Help opens the &khelpcenter; to +the relative section of the &appname; manual. + + + +Some minor settings can only be changed by editing the configuration file itself. See Hidden Options. + + + +<guilabel>General Options</guilabel> + + +The General Options Dialog + + +The General Options Dialog + + + + +The General Options control the general behavior. Images may be included +in the data files, or saved separately in the &appname; application folder. Also, when &appname; +is started, it can automatically reopen the last data file that was open. The +Tip of the Day dialog contains helpful hints on using &appname; +and appears at program startup. You may want to read through some of the hints and +then disable the dialog. + + + +The Formatting Options control the level of automatic formatting +that &appname; does. For examples, see the Field +Formatting section. Capitalization and formatting are distinct options, since +a field may be capitalized without having the order of the words changed, and +vice-versa. The auto-capitalization can be changed to ignore certain words. +The automatic formatting includes grammatical articles in titles, +along with prefixes and suffixes for personal names. The values are case-insensitive, +and should be separated by a semi-colon. + + + +The formatting rules follow general English usage, which may not work for other languages. +Articles are appended to the end of the title, with a comma. Personal names are formatted +to have the last name first, followed by a comma, then the first name. Personal suffixes, +such as Jr., are kept with the last name. Prefixes, such as von, +are kept with the last name, but are ignored when the values are being sorted. + +John Q. von Public, III would become +von Public, III, John Q. and Public would +be used as the sort key. + + +Only single word prefixes are supported. If a name includes van der, +for example, both van and der should be included +in the surname prefix list. Articles ending with an apostrophe are supported for sorting +order, as well. + + +The actual values in the collection are not changed, +only the visible text used for the interface. So the formatting options can be +changed back and forth without affecting any of the data in the collection. + + + + +<guilabel>Printing Options</guilabel> + + +&appname; uses an &xslt; template for creating &html; +and then passes that to the &kde; printing service. Only the fields visible in the &detailed-view; are printed. Furthermore, if the collection +is being filtered, only the visible entries will be printed. Initially, a warning message +is shown if filtering is active. + + + +The Print Options Dialog + + +The Print Options Dialog + + + + +The Printing Options allow you to change some formatting when +printing a collection. If Format titles and names is checked, +then the fields are auto-formatted when they +are printed. Otherwise, they are printed exactly as they were entered. + + + +The default printing stylesheet prints the collection with the field values in columns. +Print field headers controls whether the field title is printed +at the top of the column. + + + +In the printout, the entries will be sorted as they are in the &detailed-view;. Additionally, they may be grouped as they are in the &group-view;. + + + +Finally, when image fields are included in the printout, the images may be resized, +while maintaining their aspect ratio. The maximum image width and height define the +largest possible size of the image, though it will never be increased. + + + + +<guilabel>Template Options</guilabel> + + +The &entry-view; uses templates to show the field +values. You can specify a different template for each collection type. Some templates, +such as the Album or Video templates are +for a specific collection type, and a short error message will appear in the +&entry-view; if they are used for other types. The +Preview button pops up a window to show you a preview of what the template looks like. +Custom fonts and colors may be passed to the template, and all of the default templates +will honor those settings. However, custom template may choose to ignore them. + + +Additional templates may be installed directly, or downloaded from +kde-files.org by clicking +the Download button. Any templates installed by the user may also be deleted. +Entry templates are saved in $KDEHOME/share/apps/tellico/entry-templates/. + + +If you create a new template, please consider submitting it at kde-files.org! + + +The Template Options Dialog + + +The Template Options Dialog + + + + + + +<guilabel>Data Sources Options</guilabel> + + +&appname; can use various sources for importing data, which can be configured +in the Data Sources Dialog. There are several available types of sources: + + +Amazon.com Web Services, +the Internet Movie Database, +z39.50 servers, +SRU servers, +Entrez (PubMed) databases, +Yahoo! Audio Search, +AnimeNfo.com, +Internet Bookshop Italia, +ISBNdb.com, +GCstar Plugins, +arxiv.org, +bibsonomy.org, +citebase.org, +crossref.org, +other external scripts or applications + + + +The Data Sources Options Dialog + + +The Data Sources Options Dialog + + + + +New sources may be added by clicking the New... button, while +existing ones may be modified or deleted, using the Modify... or +Remove buttons. The order of the sources, which shows up in the +entry updating menus, can also be changed. + + + +Additional templates may be downloaded from the author's online repository by clicking +the Download button. Those scripts are gpg-signed by the author to +guard against dangerous scripts from unknown sources, which could cause damage to your system. + + + + +Never install and run a script from an untrusted source. They are executed with the same permissions as the user, +and as a result, could modify or delete files or otherwise mess up your system. + + + + +Many of the data sources offer more information than the default fields in &appname;. Those other fields are +shown on the right of the configuration box. If any of those fields are checked, they will be added +to the collection when an entry is added from that source. + + + +Amazon.com + + +Using the Amazon Web Services, &appname; can search any of six different international sites operated by Amazon.com for information: United States, United Kingdom, Germany, Japan, +France, and Canada. + + + + + + + + + +Configuring each Amazon.com source involves three settings: the server location, image size, and associate's ID. Some information +from Amazon.com may include an image, such as a book or video cover. That image may be downloaded in three different sizes, depending on the item. The associate's ID must be used to access the Amazon.com Web Services, and is included in the links back to the item, as dictated by the license agreement for the use of the Amazon.com Web Services. + + + + + +Internet Movie Database + + +The Internet Movie Database provides information about movies and videos. When a search is conducted for a Person, if more than one possible result is returned, a dialog box is opened to allow you to select the correct person. The configuration options include setting the web server address and whether images are grabbed or not. Since IMDb can return a large number of cast members, you can limit +that to a certain number. + + + + + + + + + + + +z39.50 Servers + + +The z39.50 protocol is used to access libraries and bibliographic information providers around the world. Lists of public z39.50 servers are available from indexdata.dk, among others. &appname; comes with +several preset configurations for major libraries, or you can specify the connection information manually. + +&appname; +is able to read data in the MODS, USMARC/MARC21, or UNIMARC format, using the yaz library. +In addition, there is limited support for the GRS-1 format. + + + + + + + + + + +To use one of the preset libraries, check the box and then select the library. The other configuration entries will be disabled. If you need to set the information manually, uncheck the preset box. + + + +The default port for z39.50 access is 210, but some servers may use a different one. &appname; assumes the server uses the MARC-8 character encoding, unless configured otherwise. If an incorrect character encoding is used, an error message may appear on the program output, or possibly no entries are retrieved. + + + +Some servers require a username and password for access. &appname; can use and save that password, but be aware that is written to the &appname; configuration file in plain text and is not secure. For most public servers, the username and password fields may be left empty. + + + + + +SRU Servers + + +SRU stands for Search/Retrieve via URL and is a standard search protocol for +Internet searches. Some libraries use it for providing access to their data catalogs. Among them, the US Library of Congress is probably +the best known. + + + + + + + + + + + +Entrez Databases + +Entrez is the integrated, text-based search and retrieval system used at the National Center for Biotechnology Information (NCBI). The most well-known Entrez database is PubMed, the database for life science articles from many biological journals. At the moment, the only Entrez database supported by &appname; is PubMed. + + + +Yahoo! Audio Search + +The Yahoo! Audio Search may be used to search for music album information. + + + + +AnimeNfo.com + +AnimeNfo is a popular site for information on anime, or Japanese animation. + + + + +Internet Bookstore Italia + +IBS, or Internet Bookstore Italia, is an online Italian bookstore. + + + + +ISBNdb.com + +ISBNdb.com is an online book database, with data collection libraries around the world. + + + + +GCstar Plugins + +If GCstar is installed, &appname; is able to take advantage of the wide range of search plugins available for GCstar. Depending on the collection type, various online resources are available for usage as a data source in &appname; + + + + +Bibliographic Databases + +arXiv.org, Bibsonomy, Citebase, and CrossRef are online databases for academic articles and bibliographic information. For access to the CrossRef source, you must request an account and add your account information to the data source configuration. + + + +External Scripts or Applications + +As an easier way for &appname; to integrate with third-party plugins, external scripts or applications may be used as an interface for searching other information sources. &appname; will execute a command, and pass the search terms as command-line options. + + +Some scripts are distributed with &appname; itself. Allocine.fr is an online French bookstore. This data source requires Python to be installed. The Spanish Ministry of Culture is an online Spanish book database. This data source also required requires Python to be installed. Dark Horse Comics is a comic book publisher. This data source also requires Python. BoardGameGeek is a website with extensive data for board games, and the script requires ruby. + + + + + + + + + +The collection type returned by the script must be set, along with the data format. Not only can &appname; import data from scripts that +use the default &appname; &xml; format, but it can also import other formats as well, such as bibtex. + + +The full path to the application should be entered in the source options. Be aware that the application is executed on the system with the same permissions as the current user, so do not use scripts from untrusted sources. Check the boxes next to the search keys supported by the application, and enter the required command line options in the edit box. The search value will be inserted where %1 appears. + + + +For updating entries already in the collection, the final checkbox and edit box are used to determine the command-line options. The entry fields used to find an update must be entered, in the same format as used for Dependent fields. + + + + + + diff --git a/doc/en/csv-dialog.png b/doc/en/csv-dialog.png new file mode 100644 index 0000000..d2dbf93 Binary files /dev/null and b/doc/en/csv-dialog.png differ diff --git a/doc/en/details.docbook b/doc/en/details.docbook new file mode 100644 index 0000000..0ad0ddb --- /dev/null +++ b/doc/en/details.docbook @@ -0,0 +1,547 @@ + +&appname; Details + + +Field Types + + +Each collection may have an unlimited number of fields. &appname; supports +eleven types of fields, which allow for a range of different data. + + + +Simple Text + + +The most basic field type is called Simple Text. +No restrictions are placed on the field values, and the data entry +widget is the standard line edit. This type is appropriate for fields +which aren't expected to have long values, such as the author or the genre. + + + + +Number + + +The Number type is identical to the +Simple Text, except that the data is restricted +to being numerical. Entries will be sorted numerically in the column +view if a Number field column is clicked. The +standard line edit, with small arrow buttons for increasing or decreasing +the value, is used for data entry. No formatting is ever +applied. + + + + +&URL; + + +The &URL; type allows for links to other documents, +using the standard &kde; file type associations for opening the linked +documents. No validation is done on the actual value of a +&URL; field, but non-valid links are not +opened. The data entry is a line edit with a button for opening the +standard File-Open dialog, but any &URL; may be used. Relative &URL;s are +interpreted relative to the location of the data file, once it has been saved. + + + +In the &entry-editor;, +the label becomes the link, while in the &entry-view;, an actual +hyperlink is used. This field type is convenient for linking to PDF +files of bibliographic entries, or to movie reviews, for example. No +formatting is ever applied. + + +Relative &URL;s may also be used. They are interpreted relative to the location of the +&appname; data file. In the &entry-editor;, the line +edit provides auto-completion for local file locations. If you want the &URL; from the &kde; +File Selector Dialog Box to be interpreted relative to the document location, then an extended +property for the &URL; field should be set to relative : true. + + + + + +Paragraph + + +For longer text fields, the Paragraph type offers +a larger text edit area, and is always in its own category. A +Paragraph field may not have multiple values, nor +is it automatically formatted. It cannot be used for grouping. Abstracts, plot +summaries, or reviews should be entered using this field type. + + + + +Choice + + +When a field should be limited to a few preset values, a +Choice type is used. The acceptable values are +presented in a drop down box for selection. Obviously, multiple values +are not applicable. Fields such as bibliography type or personal rating +are Choice-type fields. + +Semi-colons should be used to separated the allowed values. + + + + +Checkbox + + +For fields which take a yes or no value, the +Checkbox type is available. By default, the field +is toggled off. Checkbox fields are not formatted +and are limited to single values. Internally, the field values are +carried as true or +false. Some examples are gift or loaned +fields. + + + + +Date + + +A Date field can include a day, month, and year. The date is shown in the standard format of YYYY-MM-DD, which allows for easy sorting. The standard &kde; Date Selector may be used to choose the date with the mouse, or it may be entered directly. The field is not required to have non-empty values for the year, month, and day; only the year may be entered, for example. Multiple values are not allowed. + + + + + +Table + + +Table fields hold a one or more columns of values. +In the &entry-editor;, the field is presented using a +spreadsheet-like view, with numbered rows. When the last row is selected, an additional +row is then added. Auto-completion is not available. +This field is useful for a list of chapters in a book, scenes in a movie, or songs in an album. +Table fields are always a category by themselves. + + + +The number of columns, up to a maximum of ten, is defined by adding a property to the field +definition with the name columns. The columns may be labeled by right-clicking +on the header, or by setting a field property named column1, etc. + + + +When using the &entry-editor; for Table fields, rows may be rearranged by dragging +the mouse while holding the &Ctrl; button. A popup menu is also available by right-clicking on the table, +which allows rows to be inserted or removed. + + + + + +Image + + +Image fields hold an image, of any format supported by &kde;. +Some of the typical ones include PNG or JPEG. +The image can be saved inside the &appname; data file itself or in the application data +directory. The standard &kde; File Selector is used, so you can use a &URL; or just a +file available locally. Images can also be dragged from a file manager or browser. + + + + + +Rating + + +Rating fields show a number of stars to represent a numerical rating +for an entry. By default, the rating is a maximum of five. The minimum and maximum may be +changed by setting properties in the field definition in the &fields-dialog;, named +minimum and maximum, respectively. + + + + + +Dependent + + +The final field type is the Dependent field. You probably won't use +this one very often. It is used to combine values from other fields using a format +string in the field description. For example, if a Dependent field has +a description of %{title} %{year}, then the value of that field will +be the title, followed by the year. This field type is used primarily for the title field in +the coin, stamp, trading card, and wine collections. Either the internal field name or the field title +may be used in the description for formatting. +The entry ID is also available using %{id}. + + + + + + +Collection Types + + +&appname; supports twelve specific collection types by default: books, bibliographic entries, comic books, videos, music, video games, trading cards, coins, stamps, wines, board games, and file catalogs. In addition, an empty generic collection template is available for any other collectibles. The default collections are only meant to include a general set of fields. You should add, modify, or delete them to fit your needs. The only requirement is that a collection should always have a Title field, so that the &group-view; works correctly. For some collection types, that is just a Dependent field combining two or more of the others. + + + +In general, there's no functional difference between the collection types. You could create a custom collection for your books just as easily as using the default book collection. But &appname; chooses icons based on collection type, and there may be some specialized functionality that is unique to a certain collection, so if you can, you should use the defaults. So, if you want to create a wine collection, but don't like any of the default fields, go ahead and create a default wine collection, then delete all the defaults. That way, &appname; still knows that it's a wine collection. + + + +Book Collections + +Book collections have 26 default fields: +Title, +Subtitle, +Author, +Binding, +Purchase Date, +Purchase Price, +Publisher, +Edition, +Copyright Year, +Publication Year, +ISBN#, +LCCN#, +Pages, +Language, +Genre, +Keywords, +Series, +Series Number, +Condition, +Signed, +Read, +Gift, +Loaned, +Rating, +Front Cover, and +Comments. + + + +The ISBN# field is special, since ISBN numbers are automatically formatted and the check-digit is calculated. &appname; recognizes the ISBN field if its internal field name is isbn. If you delete it, or need to add it to another type of collection, create the field with the title as ISBN and apply the change, then you can return and modify the title as you want. &appname; creates the internal name based on the initial title, but never changes it if the title is later updated. + + + + + +Bibliographies + +Bibliographies have 25 default fields: +Title, +Entry Type, +Author, +Bibtex Key, +Book Title, +Editor, +Organization, +Publisher, +ISBN#, +Address, +Edition, +Pages, +Year, +Journal, +Month, +Number, +How Published, +Chapter, +Series, +Series, +Volume, +Cross-Reference, and +Keywords, +Abstract, +Notes. + + + +Although bibliographic collections are not specifically linked to bibtex, the default set of fields is taken from a typical set of bibtex fields. When exporting to bibtex, an extended property called bibtex is used for each fields to define the corresponding bibtex field. If you add an additional field to a bibliography and want to export it to bibtex, be sure to set the bibtex extended property. + + + +&appname; does have some specialized functions for bibliographies. Bibtex string macros can be added, modified, or deleted from within &appname; and the bibtex export gives you the option of expanding the macros. Bibtex citations can be pushed to an external application such as LyX or Kile using the so-called lyxpipe. + + + +Book collections can be converted to bibliographies. Default bibtex fields are added, and the extended properties are set. This functionality exists primarily to convert old collections, before the bibliography type was separated from the book collection type. + + + + +Comic Book Collections + +Comic book collections have 22 default fields: +Title, +Subtitle, +Writer, +Artist, +Series, +Issues, +Publisher, +Edition, +Publication Year, +Pages, +Country, +Language, +Genre, +Keywords, +Condition, +Purchase Date, +Purchase Price, +Signed, +Gift, +Loaned, +Front Cover, and +Comments. + + + + + +Video Collections + +Video collections have 30 default fields: +Title, +Medium, +Production Year, +Certification, +Genre, +Region, +Nationality, +Format, +Cast, +Director, +Producer, +Writer, +Composer, +Studio, +Language Tracks, +Subtitle Languages, +Audio Tracks, +Running Time, +Aspect Ratio, +Widescreen, +Color Mode, +Director's Cut, +Plot Summary, +Personal Rating, +Purchase Date, +Purchase Price, +Gift, +Loaned, +Cover, and +Comments. + + + +The Cast field is a table with two columns, and the name of the actor is intended to be in the first column, with their role in the second. The Running Time is meant to be in minutes, though you can change that, of course. + + + + +Music Collections + +Music collections have 15 default fields: +Title, +Medium, +Artist, +Label, +Year, +Genre, +Tracks, +Rating, +Purchase Date, +Purchase Price, +Gift, +Loaned, +Keywords, +Cover, and +Comments. + + + + + +Game Collections + +Video game collections have 16 default fields: +Title, +Platform, +Genre, +Release Year, +Publisher, +Developer, +ESRB Rating, +Description, +Personal Rating, +Completed, +Purchase Date, +Purchase Price, +Gift, +Loaned, +Cover, and +Comments. + + + + + +Card Collections + +Trading card collections have 17 default fields: +Title, +Player, +Team, +Brand, +Card Number, +Year, +Series, +Card Type, +Purchase Date, +Purchase Price, +Location, +Gift, +Keywords, +Quantity, +Front Image, +Back Image, and +Comments. + + + + + +Coin Collections + +Coin collections have 16 default fields: +Title, +Type, +Denomination, +Year, +Mint Mark, +Country, +Coin Set, +Grade, +Grading Service, +Purchase Date, +Purchase Price, +Location, +Gift, +Obverse, +Reverse, and +Comments. + + + + + +Stamp Collections + +Stamp ollections have 18 default fields: +Title, +Description, +Denomination, +Country, +Issue Year, +Color, +Scott#, +Grade, +Cancelled, +Hinged, +Centering, +Gummed, +Purchase Date, +Purchase Price, +Location, +Gift, +Image, and +Comments. + + + + + +Wine Collections + +Wine collections have 15 default fields. +Title, +Producer, +Appellation, +Varietal, +Type, +Country, +Purchase Date, +Purchase Price, +Location, +Quantity, +Drink By, +Rating, +Gift, +Label Image, and +Comments. + + + + + +Board Game Collections + +Board game collections have 15 default fields. +Title, +Genre, +Mechanism, +Release Year, +Publisher, +Designer, +Number of Players, +Description, +Rating, +Purchase Date, +Purchase Price, +Gift, +Loaned, +Cover, and +Comments, + + + + + +File Catalogs + +File catalogs have 13 default fields. +Name, +URL, +Description, +Volume, +Mimetype, +Size, +Permissions, +Owner, +Group, +Created, +Modified, +Meta Info, and +Icon, + + + + + +Custom Collections + +Custom collections have one default field, the Title. They should be used when the collectible item is not one of the default types. + + + + + + + diff --git a/doc/en/entry-editor1.png b/doc/en/entry-editor1.png new file mode 100644 index 0000000..c371d9d Binary files /dev/null and b/doc/en/entry-editor1.png differ diff --git a/doc/en/entry-editor3.png b/doc/en/entry-editor3.png new file mode 100644 index 0000000..38ff114 Binary files /dev/null and b/doc/en/entry-editor3.png differ diff --git a/doc/en/entry-editor4.png b/doc/en/entry-editor4.png new file mode 100644 index 0000000..e9bac5b Binary files /dev/null and b/doc/en/entry-editor4.png differ diff --git a/doc/en/entry-editor5.png b/doc/en/entry-editor5.png new file mode 100644 index 0000000..73c9773 Binary files /dev/null and b/doc/en/entry-editor5.png differ diff --git a/doc/en/export-bibtex.png b/doc/en/export-bibtex.png new file mode 100644 index 0000000..0bf9cfb Binary files /dev/null and b/doc/en/export-bibtex.png differ diff --git a/doc/en/export-csv.png b/doc/en/export-csv.png new file mode 100644 index 0000000..f2c21dd Binary files /dev/null and b/doc/en/export-csv.png differ diff --git a/doc/en/export-html.png b/doc/en/export-html.png new file mode 100644 index 0000000..617e52e Binary files /dev/null and b/doc/en/export-html.png differ diff --git a/doc/en/export-options.png b/doc/en/export-options.png new file mode 100644 index 0000000..881ddc5 Binary files /dev/null and b/doc/en/export-options.png differ diff --git a/doc/en/export-pdb.png b/doc/en/export-pdb.png new file mode 100644 index 0000000..067a3d0 Binary files /dev/null and b/doc/en/export-pdb.png differ diff --git a/doc/en/externalexec-options.png b/doc/en/externalexec-options.png new file mode 100644 index 0000000..bb5448f Binary files /dev/null and b/doc/en/externalexec-options.png differ diff --git a/doc/en/faqs.docbook b/doc/en/faqs.docbook new file mode 100644 index 0000000..f03c2ae --- /dev/null +++ b/doc/en/faqs.docbook @@ -0,0 +1,257 @@ + +Questions and Answers + + + + + + + +How do I start the program? + + + +After downloading and unpacking &appname;, run +configure + + to configure +everything. You may need to modify some of the command line +options. After that, running +make will compile +&appname;. Then, as root, run make +install to install everything. Being root is +only necessary if you install somewhere where you don't have write +permissions. The command line to start &appname; is +tellico. If you install one +of the pre-packaged binaries, a menu item will be inserted for +&appname;. + + + + + + +How do I enter multiple authors? + + + +Author names should be separated by a semi-colon, like so: +Brian W. Kernighan; Dennis M. Ritchie. Don't +include the word "and" or anything similar, even if you have 20 +authors. If you have the auto-format option checked, then the last +name will automatically be shown first for each author. + +Other properties which allow multiple values, like "genre" and +"keywords", are entered in the same way, with a semi-colon (;) +separating each value. + + + + + + +Can I modify what the printed page looks like? + + + +Yes, most certainly. Find the file tellico-printing.xsl which + should be in the $KDEDIR/share/apps/tellico/ directory. You can copy + that to $KDEHOME/share/apps/tellico/ for personal modifications. + You'll have to know &xslt;, but modifying that file + is how you change the printing layout. &html; is generated from the + file, and the easiest way to change the appearance of the printout is + to modify the CSS in the top portion. Feel free to email me with questions. Any alternate &xslt; printing files will be available on the &appname; website. + +Be aware that the tellico-printing.xsl references another file, tellico-common.xsl, that contains some common &xslt; templates. If you copy +tellico-printing.xsl to $KDEHOME, you must either modify the <xsl:import> element to point to the actual location of the tellico-common.xsl file or copy the common file as well. + + + + + +How do I group by a property other than the ones listed in the toolbar? + + + +To allow grouping by a field which doesn't allow grouping by default, check the +"Allow Grouping" box for that particular field in the "Collection Fields" dialog. + + + + + +Why does all that gobbledy-gook show up when I run &appname;? + +Stuff like: + +Tellico::updateCollectionToolBar +GroupView::setGroupAttribute - author +GroupView::slotAddCollection +QCheckBox::property( "title" ) failed: property invalid +or does not exist + + +is debug info. At compile time, this can be stopped by compiling with +the flag. You +might also want to use +, too, which +takes a bit more memory when compiling, but is more efficient when +running the application. + +The last message is slightly different, it just means your Qt + installation was compiled with some debugging information. + +Or, if &appname; is already installed, run +kdebugdialog and make sure +that "0 (generic)" is unchecked. That turns off debug messages from +all generic KDE apps i.e. those not distributed officially by +KDE. + + + + + +How do I change which columns are shown? + +Right-click on the header bar. You can also drag the headers to re-order +the columns, and click on them to sort by that field. + + + + +How do I filter by something like the "Read" +field? + +Internally, the checkbox +fields in &appname; are saved as "true", so if you'd like to filter +to show only the science fiction books which you've not read, for +example, then you have two rules. Make sure the "Match all of the +following" button is checked. Set the first rule to have "Genre" +"contains" "Science Fiction" (no quotes) and the second rule to have +"Read" "does not contain" "true" (no quotes). + +Also, the quick filter in the toolbar will match any field, +and if there is a non-word character, the text is interpreted as a +regular expression. So if you quickly want to filter your books to +show those by Weber or Bujold, then type "weber|bujold" (no quotes) in +the toolbar. + + + + +How do I add new entry templates? + + +Entry templates should be saved in +$KDEHOME/share/apps/tellico/entry-templates/ +for access for a single user or +$KDEDIR/share/apps/tellico/entry-templates/ +for access by everyone. Templates in $KDEHOME will +override any files by the same name in $KDEDIRS. The +entry templates can be set on a per collection-type basis in the +settings dialog. + +Templates for the &report-dialog; are saved in $KDEHOME/share/apps/tellico/report-templates/. + + + + + +Compiling and installing went +fine, but when &appname; starts up, the window is blank. What's +wrong? + + +KDE programs look for data in the locations defined in the + $KDEDIRS environmental variable. If you install in + /usr/local for example, but + $KDEDIRS is empty or just /usr, + then &appname; won't be able to find the files it needs. This is + particularly true for SuSE, for which you should compile with + =/opt/kde3. Alternatively, + you could add a line to your .profile file to + set $KDEDIRS. Check the documentation for your + shell. + + + + +How do I export additional bibtex fields? + +&appname; uses the bibtex property to know how to export + bibtex fields. If you want to add additional fields to export, such + as an abstract, open up the &fields-dialog;, and click the Extended + Properties button. Add a bibtex property with value + abstract. Then, when you export to bibtex or bibtexml, that + property will be used for the bibtex field name. + + + + + +What happened to Bookcase? + + + +Due to a trademark conflict, Bookcase was renamed Tellico in September 2004. +Tellico 0.12 was then released, which was identical to +Bookcase 0.11, except for the name change. + + + + + +What does the name Tellico have to do with anything? + + + +I thought about several +other names, a few of which were connected with book collections. However, +Tellico can handle more than just books, and besides, this is a hobby, so I chose +a neat-sounding (to me) name, one taken from a town close to where I grew up. + + + + + +What do you include those links to Amazon.com in the search results? + + + + +The terms of agreement for accessing the Amazon.com Web Services require all images pulled from the service to be linked back to Amazon.com, as well as an additional link. The Amazon.com associate's ID is neccessarily included, so any referral payments are duly collected. + + + + + + +Why don't you use a real database? + + + + +Part of the reason I started &appname; was to learn C++. I didn't know SQL at the time, and at the moment, I only have a faint knowledge +of how to use it. Simply put, &appname; didn't start out as a relational database, and that won't change until sometime in the future when +I get around to learning SQL and have the time and motivation to change the data model. If that bothers you, well, don't use &appname; then. + + + +Of course, anyone is welcome to make any changes they want to with the source code. + + + + + + + diff --git a/doc/en/fetch-dialog.png b/doc/en/fetch-dialog.png new file mode 100644 index 0000000..eee5ef6 Binary files /dev/null and b/doc/en/fetch-dialog.png differ diff --git a/doc/en/fields-dialog.png b/doc/en/fields-dialog.png new file mode 100644 index 0000000..932ed29 Binary files /dev/null and b/doc/en/fields-dialog.png differ diff --git a/doc/en/filter-dialog.png b/doc/en/filter-dialog.png new file mode 100644 index 0000000..d10842c Binary files /dev/null and b/doc/en/filter-dialog.png differ diff --git a/doc/en/filter-view.png b/doc/en/filter-view.png new file mode 100644 index 0000000..2d8752e Binary files /dev/null and b/doc/en/filter-view.png differ diff --git a/doc/en/freebsd-doc-license.html b/doc/en/freebsd-doc-license.html new file mode 100644 index 0000000..ae93752 --- /dev/null +++ b/doc/en/freebsd-doc-license.html @@ -0,0 +1,57 @@ + + + + FreeBSD Documentation License + + + + + + + + + +

FreeBSD Documentation License

+ +

Redistribution and use in source (SGML DocBook) and 'compiled' + forms (SGML, HTML, PDF, PostScript, RTF and so forth) with or + without modification, are permitted provided that the following + conditions are met:

+ +
    +
  1. +

    Redistributions of source code (SGML DocBook) + must retain the above copyright notice, this list + of conditions and the following disclaimer as the + first lines of this file unmodified.

    +
    2. + +
  2. +

    Redistributions in compiled form (transformed to + other DTDs, converted to PDF, PostScript, RTF and + other formats) must reproduce the above copyright + notice, this list of conditions and the following + disclaimer in the documentation and/or other + materials provided with the distribution.

    + +
    3. +
+ +

THIS DOCUMENTATION IS PROVIDED BY THE FREEBSD + DOCUMENTATION PROJECT "AS IS" AND ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL + THE FREEBSD DOCUMENTATION PROJECT BE LIABLE FOR ANY + DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF + USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER + IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE + USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE.

+ + diff --git a/doc/en/fundamentals.docbook b/doc/en/fundamentals.docbook new file mode 100644 index 0000000..046a651 --- /dev/null +++ b/doc/en/fundamentals.docbook @@ -0,0 +1,595 @@ + +Using &appname; + + +Quick Start + + +By default, &appname; starts with an empty book collection. To work with some other type of collection, create it using the FileNew menu item, or the button on the toolbar. Collections are populated with some of the more common fields, but you can add, modify, or delete them to suit your needs. + + + +New entries can be added by using the &entry-editor;. The CollectionNew Entry menu item will open the &entry-editor; with an empty entry ready for editing. The &entry-editor; can also be opened by using the SettingsShow &entry-editor; menu item. Once you've entered the values for the entry, you can save it to the collection by using the Save Entry button in the &entry-editor; dialog, which remains open in case you want to continue adding new entries. Once you've saved an entry in the collection, you can modify it by clicking on it in the main window. If the &entry-editor; is not already open, you can double click an entry to open the editor and start editing. + + + +If you want to include an image in the entry, you can use the standard &kde; File Selector by clicking the Select Image... button in the &entry-editor;, or you can drag an image from the file manager or web browser into the &entry-editor;. + + + +When you select an entry, the &entry-view; shows a formatted view of the entry's contents. You can change the template used for showing the entry in the &config-dialog;. + + + +The entries in the collection are grouped together when they share the same values for certain fields, such as the author or director. You can change the field used for grouping by using the combo box in the toolbar or the SettingsGroup Selection menu item. + + + +You can use the &quick-filter; in the toolbar to quickly limit the visible entries to ones which contain the word you type. The filter is also useful when you want to quickly find an entry. You can type in the title or some other unique word that identifies the entry and the &detailed-view; will only show the entries that match the filter. The status bar shows you how many entries are in the collection, and how many are currently being filtered. + + + + + +General Usage + + +The main window has three distinct areas, all of which show information about the collection +in a different manner. The primary view is the &detailed-view; in +the upper right area, where the value of every field for each entry may be shown. On the left side, tabs +hold the &group-view;, which can be used to sort the entries into groups +in a tree-structure, the &filter-view;, which is used to track which +entries meet cerrtain critera, and the &loan-view;, where any loans are +listed. Finally, the &entry-view; shows a formatted view +of the data for a single entry, or an icon view of a group of entries, in the lower right. + + + +The &appname; Main Window + + +The &appname; Main Window + + + + +&detailed-view; + + +Any of the fields in the collections may be shown in the &detailed-view;, although Paragraph, Image, and Table fields will probably not be useful. Right-clicking on the header of the view opens a menu for selecting the visible fields. The columns may be resized and reordered in any way, and the settings will be saved between sessions. + + + + +&group-view; + + +The &group-view; groups the entries in a tree-view by any field which allows grouping. +The number of entries in each group is shown next to the group name. Groups may be expanded or collapsed by clicking the plus sign, or by double-clicking the item. Expanding and contracting all the groups are options in the right-click context menu. The tree may be sorted either by the group name, or by the count, by clicking on the header. A group may also be used as a filter for the &detailed-view;, by right-clicking on the group item. + + + +When more than one field in the collection has the Format as name option turned on, an additional group is added to combine all those fields into one single People pseudo-group. + + + +If an entry does not contain a value for the field being used to form the groups, it is placed in the (Empty) group, which uses a red folder. + + + + +&filter-view; + + +If any filters are saved for the collection, the &filter-view; becomes active. As you add or +modify entries, they will automatically be checked against the filters and add or removed as +appropriate. The filter may be modified by double-clicking on the item to open +the &filter-dialog;. Right-clicking gives you the option to delete it altogether. + + + +The &filter-view; + + +The &filter-view; + + + + + + +&loan-view; + + +Once entries are checked-out on loan, the &loan-view; is added to the window, so those +borrowed entries may be tracked. Loans are tracked on a per-entry bases, so right-clicking +on an entry item has an option for modifying the loan using the &loan-dialog;. + + + +The &loan-view; + + +The &loan-view; + + + + + + +&entry-view; + + +A formatted representation of the entry's values is shown in the &entry-view;. Templates are used for the layout and any additional graphics. Separate templates for each type of collection may be specified in the &config-dialog;, along with custom colors and fonts. + +All of the default templates honor the color and font selection, but other custom templates might now. +The default templates also make &URL; fields active, which will open up with the default &kde; file association. When exporting to &html;, the current template is used for exporting the individual entry files. + + + +In addition, when multiple entries are selected, an icon view is shown, using the first Image field in the collection. Entries may be selected as in the &detailed-view;. Right-clicking in the icon view will show a menu that changes the sorting criteria for the entries. + + + + + +Statusbar + + +The status bar is used to show you what &appname; is currently doing. It also includes a total count of the entries in the collection, and if a filter is being used, how many are currently visible. + + + + + + +Editing Entries + + +The &entry-editor; is used to add and modify entries in the collection. Double-clicking on an entry in either the &group-view; or the &detailed-view; opens the &entry-editor; with that entry. New entries may be created using the Collection menu, the toolbar icon, or the button in the &entry-editor; itself. + + +The arrow buttons on the bottom will move to the previous or next entries in the current list. + + +Closing the &entry-editor; when changes have been made but not saved will cause a warning message to appear. The fields are grouped by category and appear in the order that they appear in the &fields-dialog;. They may also be reordered. + + + +The &entry-editor; + + +The &entry-editor; + + + + +Clicking the field title for a &URL; field will open the link using the default &kde; file association. The &URL; selector button beside the text entry will open the default &kde; File Open Dialog, but the field is not limited to local files. + + + +For Image fields, the Select Image... button opens up the &kde; image file selection dialog. The image is saved in the collection in the original format, and a scaled version is shown in the &entry-editor;. The image may be cleared by using the Clear button. Cleared images are removed from the collection. + + +The &entry-editor; for Image fields + + +The &entry-editor; for Image fields + + + + +The edit widget also supports drag-and-drop. Dragging an image file from a file-manager or browser window does the same thing as selecting the image in the File Selector. Dragging an image from the edit widget into a &konqueror; file manager window will save the image in that folder. + + + + +By default, the images are stored in the collection data file, keeping everything contained in one location. However, too many images will cause &appname; to slow down significantly as well result in a very large data file. Alternatively, &appname; can save the images separately, either in the $KDEHOME/share/apps/tellico/data/ directory or in a directory in the same location as the data file. Loading and saving data files is much faster if images are stored separately, but the data files are no longer portable or archivable. +Self-contained data files can always be created by using the FileExportExport to Zip... menu item. + + + + +Table fields begin with five rows, but moving the cursor to the last row automatically adds another. For multi-column tables, only the first column is used for grouping or formatting. + + + +The &entry-editor; for Table fields + + +The &entry-editor; for Table fields + + + + +Editing Multiple Entries + +Multiple entries may be edited at the same time by selecting more than one in either the &group-view; or the &detailed-view;. If multiple entries are selected, the fields which contain the same value in every entry are enabled. If entries have different values, then the fields are disabled. Check boxes are added to the extreme right for each field entry which control whether the field is enabled or not, as shown in the screenshot below. + + + +Only enabled fields will be modified when the entries are saved, which makes large-scale editing much easier. For example, to set the Medium of all the video entries in the collection, make sure the Medium field is enabled. Change it to DVD, then save the entries. Only the Medium field will be modified, preserving all the other field values for the entries. + + + +The &entry-editor; for multiple entries + + +The &entry-editor; for multiple entries + + + + + + +Updating Entry Data + + +Entries may be automatically updated by querying the data sources available for the current collection type, which is very useful for combining information from multiple sources. For example, you may add a movie to your collection using +the Amazon.com Web Services, and then update the entry with additional +information from the Internet Movie Database. + + + +Only empty fields are updated unless the setting for that source allows results to overwrite existing information. For external scripts, an update field must be specified in the source options. + + + +The entry updating may be started via the right-click menu for an entry, or by using the CollectionUpdate Entry menu item. + + + + + + +Editing Fields + + +The &fields-dialog; allows you to add new fields to the collection, to modify the existing ones, or to delete fields altogether. + + + +The &appname; &fields-dialog; + + +The &appname; &fields-dialog; + + + + +Field List + + +On the left side of the dialog is the list of the current fields. Modified fields are shown in bold italics. The buttons below the list will add or delete a field, and the arrows can be used to change their order. The order of the fields in the list is important because the &entry-editor; uses the order for its layout. For each category, the fields will be laid out from left to right, according to the top-to-bottom order of the fields in the list. + + + + +Field Properties + + +A field is defined by its title, type, category, description, and possibly a default value or some allowed values. The title is used everywhere to refer to the field in the user interface. The &entry-editor; uses it to prompt for values. The &detailed-view; uses it as a column header. The different types of fields are explained in the Field Types section. The description is used as a tooltip in the &entry-editor;, perhaps to provide an explanation of the field's contents. In addition, for Dependent fields, the description is used to format the field's value. The default value is automatically added when creating a new entry. The list of allowed values for Choice fields should be separated by a semi-colon. + + + +New fields may be any type, but changing the type of existing fields is restricted to compatible types, as shown in the table below: + + + +Allowable Field Type Changes + + + +Current Type +New Type Allowed + + + + +Simple Text +Simple Text, Paragraph, Number, URL, Table + + +Paragraph +Simple Text, Paragraph + + +Choice +Simple Text, Paragraph, Choice, Number, URL, Table + + +Checkbox +Simple Text, Paragraph, Checkbox, Number, URL, Table + + +Number +Simple Text, Paragraph, Number, URL, Table + + +URL +Simple Text, Paragraph, Number, URL, Table + + +Date +Simple Text, Date + + +Table +Simple Text, Paragraph, Table + + +Image +Image + + +Rating +Choice, Rating + + +Dependent +Dependent + + + +
+ + + +Field Formatting + + +&appname; provides some capability for automatic formatting of field values. The simplest is auto-capitalization, which capitalizes every word except the articles. Title formatting moves certain articles from the beginning to the end of the field, for example, changing "The Return of the King" to "Return of the King, The". The title articles are configurable. Finally, name formatting tries to break up the string so that the last, or family, name of the person is shown first. Name prefixes and suffixes are configurable. Also, the special People group uses all fields with name formatting, even if the global setting is turned off. + + + +All automatic formatting can be disabled by changing the global options in the &config-dialog;. Globally, capitalization is a distinct option from formatting, so a title can be auto-formatted without being capitalized. Not all field types allow auto-formatting. + + + +Formatting Examples + + + +Format Type +Field Value +Auto-Capitalized +Auto-Formatted +Auto-Capitalized & Auto-Formatted + + + + +Title +the return of the king +The Return of the King +return of the king, the +Return of the King, The + + +Name +tom swift, jr. +Tom Swift, Jr. +swift, jr., tom +Swift, Jr., Tom + + + +
+ + +Field Options + + +Fields also have three general options. If auto-completion is enabled, &appname; caches the values for each field, and the &entry-editor; offers automatic completion, using the standard &kde; settings. Not all field types allow auto-completion. &appname; also needs to know if a field may have multiple values or may be used to group the entries. A semi-colon is used to separate multiple values when editing an entry; + + + +For efficiency, do not enable auto-completion unless you need it for the fields. The more fields with auto-completion in the collection, the slower it takes &appname; to load the file. + + + + + + +Filtering Entries + +The &filter-dialog; allows you to limit the entries visible in the &detailed-view; +to those that match one or more filter rules. +The filter may be used to find the entries that meet all of the rules in the dialog, or just to +find those that meet any of them. The &filter-dialog; is also useful for advanced searching within a collection. + + + +The &appname; &filter-dialog; + + +The &appname; &filter-dialog; + + + + +Each row contains a single filter rule. Select the field to match in the first box in the row, then select a matching rule in the center. Rules may match values that contain a certain word, or are exactly equal. A regular expression may also be used to match entries, in which case the Edit... button becomes active for editing the expression. Finally, the word or string to match should be entered in the text box. + + + +Up to eight (8) rules may be used in the filter. The More and Fewer buttons may be used to add or remove rules. + + + +Filters may be saved, so that all entries which match are grouped together in the &filter-view;. The view is dynamic, so ad entries are added or modified, the group is automatically updated. To save the filter, enter a name in the text box, and lick the Save Filter button. + + + +Previously saved filters may be modified by right-clicking on the filter item in the &filter-view; and selecting Modify Filter. The &filter-dialog; is opened, and changes may be made to the filter's name or rules. + + + + +To find the science fiction books you've not read, check the Match all of the following +button, set the first rule to Genre contains Science Fiction and the second to Read does not contain true. (For Checkbox fields, the internal value is true). + + + +To find the books by Bujold or Weber, check the Match any of the following +button, set the first rule to Author contains Bujold and the second to Author contains Weber. + + + + + + +Generating Reports + +&appname; can generate various reports about your current collection. The &report-dialog; checks for all &xslt; templates in the installation path and in $KDEHOME/share/apps/tellico/report-templates/. So you can create new ones, and they're automatically found and included as options in the &report-dialog;. Some complex reports may take a while to generate for large collections. + + + +The templates that are installed with &appname; include a list of titles only, the default column view, a group view, a summary of all of the groups and the most popular values in those groups, a loan report, and a large report with cover images. Select the desired template and click the Generate button. Any report may also be printed or saved to an &html; file. + + + +The &appname; &report-dialog; + + +The &appname; &report-dialog; + + + + +The entries included in the report will be limited to the ones in the &detailed-view; so if you've got an active filter, the &report-dialog; will use it. + + + + +Loan Tracking + +&appname; supports tracking loans of any entries in the collection. The &loan-dialog; may be opened by using the Check-out menu item, or right-clicking on an entry. Multiple entries may be checked-out at once. + + + +The borrower's name may be directly entered, or pulled from the default &kde; address book by clicking on the button next to the name entry. The check-out date is assumed to be the current date, but may be changed. The due date is optional, and other notes may be added about the loan. + + + +If a due date is entered, and &appname; is compiled with libkcal support, a loan reminder may be added to the default &kde; calendar as a To-Do item. &korganizer; can be used to view those items. + + + +When an entry is checked-out, the Loaned field is set to true. If no loaned field exists in the collection, one is added. Do not modify that field directly! Entries on-loan may be checked-in using the menu item, or right-clicking on an entry in the &loan-view;. + + + +The &appname; &loan-dialog; + + +The &appname; &loan-dialog; + + + + + + +General Tips + + +These are the list of tips contained in the "Tip of the Day" list for &appname;. + + + +If a book has more than one author, you should separate +their names by a semi-colon, so that Tellico will know to split them +and use them separately. Any other field which allows multiple values should be entered the +same way. with a semi-colon (;) separating each value. + + + + +You can change which fields are shown in the list view by +right-clicking on the column header. + + + + +You can add, edit, or modify the fields in the collection using +the &fields-dialog;. The arrow buttons below the field list can be used to change the +position of the field in the list, which affects the placement in the entry +editor. + + + + +If you want to filter by a Checkbox field, a value of +"true" should be used. If you'd like to filter to +show only the science fiction books which you've not read, for +example, check the Match all of the +following button, set the first rule to have "Genre" +"contains" "Science Fiction" (no quotes) and the second rule to +have "Read" "does not contain" "true" (no quotes). + + + + +If a non-word character is used in the Quick Filter, the text is +interpreted as a regular expression. To show only books which are by Weber or Bujold, for example, then +type "weber|bujold" (no quotes) in the filter box. + + + + +You can edit more than one entry at a time, by holding down +the &Shift; or &Ctrl; key and selecting multiple entries. + + + + +You can convert an existing book collection to a bibliography, +which can then be exported to bibtex or Bibtexml format. + + + + + +If more than one field is formatted as a name, then an additional +group named "People" is added to the collection, allowing authors and editors +to be sorted or printed together, for example. + + + + +You can modify the appearance of the printed output by modifying +the tellico-printing.xsl file. The file generates &html;, and the &css; +within the stylesheet governs things like the font, the margins, etc. + + + + +Double-clicking an entry item opens the &entry-editor;. + + + + +You can add &html; tags to any Paragraph field for formatting, such as +<b>bold</b> or <i>italic</i>. + + + + +In the &detailed-view;, you can press a letter on the +keyboard to skip to the next entry that starts with that letter. + + + + +You can use Dependent Fields to combine multiple separated fields +into a single field. Just select the type Dependent and use a description +similar to "Value: %{fielda}%{fieldb}" where %{...} gets replaced with the +appropriate field value. This is useful to collect multiple values in a +single field, e.g. for better grouping, and to combine fields of different +types by respecting proper sorting at the same time. Consider for example +a number field followed by a text subfield with entries 3b, 14a. + + + + + + diff --git a/doc/en/general-options.png b/doc/en/general-options.png new file mode 100644 index 0000000..406a271 Binary files /dev/null and b/doc/en/general-options.png differ diff --git a/doc/en/hacking.docbook b/doc/en/hacking.docbook new file mode 100644 index 0000000..89d1c54 --- /dev/null +++ b/doc/en/hacking.docbook @@ -0,0 +1,362 @@ + +Hacking &appname; + + +In the spirit of Free Software, you're welcome to hack on &appname; as much as you like. You should be able to write scripts to import, export, or modify data very easily. This chapter gives you more information about doing that. + + + +File Format + + +The default &appname; data file is a zip archive, normally with a .tc file extension. Inside the archive is a top-level tellico.xml file. Images may be included inside the images/ directory in the archive., or they may be included in the &xml; data directly in a base64 encoding. Images may also be saved inside the application data directory, in which case, they are not in the data file at all. &appname; can also load the &xml; file, by itself, uncompressed. + + + +&xml; Data + + + + + +Collection + + + + + + + +]]> + + + +The file begins with the required &xml; declaration and encoding, followed by the doctype. When a new field type is added or additional properties are set on the default fields, the doctype DTD version is incremented. &appname; is always able to open and read any previous DTD version, but will save files in the current version. The DTD location does point to an actual DTD file. + + + +The top-level element is a <tellico> element, containing the default namespace declaration and the syntax version of the file, which should always match the DTD. + + + +The <tellico> element contains one <collection> element. Multiple collections are ignored, for now. The title attribute contains the collection title, while the type specifies what kinds of entries are contained in the collection. The allowable types are in listed in a later section. An optional entryTitle attribute may be used to specify the title of the entries for a custom collection, and should be plural. + + + + +Fields + + + + + + + + + + + + + + + + +]]> + + + +All of the fields are defined inside a <fields> element, of which there can be only one. All of the information for a field, except for any extended properties, are included as attributes of the <field> element. The allowable values for the flags, format, and type attributes are given in a following section. + + + +A <field> element with a name attribute equal to _default tells &appname; to include all the default fields for that collection type. + + + + +Entries + + + + C++ Programming Language, The + + Stroustrup, Bjarne + + Addison-Wesley Pub Co + 3rd + 1997 + 0-201-88954-4 + + Non-Fiction + + + Programming + Computers + + cf65a2f023b6cb9e9233323dca10ac7c.jpeg + +]]> + + + +For every field in the collection, an <entry> may contain an element whose name is identical to the field name. If multiple values are allowed for the field, then the letter s is added to the field name to create an element, and each value is added as a child of the element, as in the case of the author, genre, and keyword fields above. + + + +As a result, if additional fields are added to the collection, the date file will no longer conform to the DTD. However, &appname; uses a non-validating &xml; parser, so additional fields do not cause problems. + + + + +Images + + + + +]]> + + + +Inside the <images> element, each image referenced by an entry is listed, along with attributes describing the image's size, format, and id. If the image is contained inside the Zip file, the element is empty. Otherwise, the image data may be contained in the &xml; stream as base64-encoded text. + + + + + + + + +Collection Type Values + + +The type of collection is given in the type attribute of the collection element. The value is equal to the Type enum value in src/collection.h. + + + +Collection Type Values + + + +Collection Type +Value + + + +Custom Collection1 +Book Collection2 +Video Collection3 +Music Collection4 +Bibliography5 +Comic Book Collection6 +Wine Collection7 +Coin Collection8 +Stamp Collection9 +Trading Card Collection10 +Video Game Collection11 +File Catalog12 +Board Game Collection13 + + +
+ + + + + +Field Type Values + + +&appname; will include all the default fields for a collection if the first field element has the name _default. For Paragraph, Table, or Image fields, the field category should be identical to the field title. + + + +The type of field is given in the type attribute of the field element. The value is equal to the FieldType enum value in src/field.h. ReadOnly fields were intended for fields which should be retained in the collection, but which should not be editable by the user, such as some fields added when importing a collection from another file format. It is not currently used. + + + +Field Type Values + + + +Field Type +Value + + + +Simple Text1 +Paragraph2 +Choice3 +Checkbox4 +ReadOnly5 +Number6 +URL7 +Single-Column Table8 +Image10 +Dependent11 +Date12 +Rating14 + + +
+ + +The field may have different flags set, given as a bitwise OR'd value in the flags attribute on the field element. The flag for preventing the user from deleting a field is intended for such things as the citation key for bibliographic entries. + + + +Field Flag Values + + + +Field Flags +Value + + + +Allow Multiple Values0x01 +Allow Grouping0x02 +Allow Completion0x04 +Disallow Deleting0x08 + + +
+ + +The format of the field is given in the format attribute on the field element. Date Formatting is not currently used. Grouping by People uses all the fields which use Name Formatting. + + + +Field Format Values + + + +Field Format +Value + + + +Capitalization Only0 +Title Formatting1 +Name Formatting2 +Date Formatting3 +No Formatting4 + + +
+ + + + +Hidden Configuration Options + + +&appname; has some additional configuration options that are not visible in the &config-dialog;. They are not important enough to warrant cluttering the dialog with more settings, but as they represent options which may appeal to various users, the application does read them from the configuration file. + + + +The settings for &appname; are saved in a file in the user's home folder, namely $KDEHOME/share/config/tellicorc. Within that file, settings are put in groups, which appear with bracketed names, such as [General Options]. To add a setting to the General Options group, find the line in the settings file with that group name. If it does not appear, then create it yourself by adding a line saying [General Options]. Then, the setting can be added underneath the group name. + + + +[General Options] + + +These settings should be placed in the General Options group. + + + +Max Icon Size + + +The maximum size of the icons in the &icon-view; may be changed with this setting. The default value is 96. The size must be in the range of 32 to 128. + + + + +Example + +Max Icon Size=72 + + + + + + +[Options - bibtex] + + +These settings should be placed in the Options - bibtex group. + + + +lyxpipe + + +This setting is for the location of the lyxpipe for sending bibliographic citations. It should not include the .in suffix. + + + + +Example + +lyxpipe=$HOME/.lyx/lyxpipe + + + + + +[Export Options - PilotDB] + + +These settings should be placed in the Export Options - PilotDB group. + + + +Charset + + +The encoding of the exported data within the PilotDB file may be changed with this setting. The default value is the character set for the user's locale. + + + + +Example + +Charset=Windows-1250 + + + + + + + +Bibtex Character Translation + + +When bibtex files are imported or exported, certain characters are translated between their TeX equivalents and the Unicode characters. Those character mappings are contained in the bibtex-translation.xml file, located in the installation data directory. The mappings can be modified, as desired. The key element contains the Unicode character, and the string elements within contain the TeX equivalents, which may be a one-to-many mapping. The first one is the one used when exporting to bibtex. + + + + + {\`A} + \`{A} + +]]> + + + + + +XSLT Tricks + + +Here are some tips for writing XSLT to parse &appname; &xml; data: (TBD). + + + + diff --git a/doc/en/imdb-options.png b/doc/en/imdb-options.png new file mode 100644 index 0000000..d4b1cb1 Binary files /dev/null and b/doc/en/imdb-options.png differ diff --git a/doc/en/importing-exporting.docbook b/doc/en/importing-exporting.docbook new file mode 100644 index 0000000..c4814f5 --- /dev/null +++ b/doc/en/importing-exporting.docbook @@ -0,0 +1,452 @@ + +Importing and Exporting Data + + +&appname; is able to import and export a wide variety of data files, as well as search various Internet sites for information. + + + +Importing from the Internet + +&appname; is able to search various Internet sites using the &fetch-dialog;. Entries may be directly imported and added to your current collection. The various providers are configured via the Data Sources Options. + + + +Searches may use five different criteria: Title, Person, ISBN, UPC/EAN, or Keyword. Not all criteria are available for certain data sources. + +Once a search is initiated, the Search button becomes Stop which will end a search. As results are found, they are added to the list directly under the search box, where selecting an item will show the result without adding it to the collection. Clicking the Add Entry button will add all the selected items to your collection. If the data source has more results than were initially requested, the Get More Results button becomes active. Clicking Clear will remove all the current results and reset the search. + + + +The &appname; &fetch-dialog; + + +The &appname; &fetch-dialog; + + + + +Only entries that match the current collection type will be found. The Description column provides additional information about the entry, in order to differentiate between videos in different formats, or books in different bindings, for example. Once an entry is successfully added to the collection, a checkmark is added to the first column in the list. + + + +Multiple entries can be added at once by using the standard &kde; method for multiple selection, which usually involves holding the &Shift; or &Ctrl; key when clicking on an item. + + + +To facilitate the use of barcode scanners, searches can include multiple ISBN values. Selecting the Multiple ISBN search check box will disable the search box and enable the Edit ISBN list... button, which will open a multi-line text entry box. Each ISBN should be entered on a line by itself. After closing the box, each ISBN will be validated for correct formatting. The ISBN validation is able to convert 13-digit EAN values, as well as full UPC codes, to the proper formatting. The ISBN list may also be read from a text file. + + + + + +Importing Data + + +&appname; offers three different actions when importing data. Replace current collection will close the current collection, and create a new one with the data from the imported file. Append to current collection tells &appname; to add all the entries in the imported collection to the current one, and to add any fields which don't currently exist. The Merge collection action is the same as appending, except that each imported entry is compared to the current ones, and any identical entries are skipped. Future plans include an improved heuristic for identifying matching entries, but currently, except for music collections, they must be identical for every field. Music collections compare the artist and album only, and the tracks are merged for matching entries. The audio file importer is able to correctly build track lists by merging entries. + + + +Importing &appname; Data + + +Other &appname; data files may be imported. Replacing the current collection by importing a &appname; file is the same thing as just opening the file itself. The value of importing &appname; data is primarily for appending or merging two collections together. + + + + +Importing CSV Data + + +Comma-separated values (CSV) are a common way of importing and exporting tabular data. Each field value is separated by a comma, with one entry per line. The field titles may be included in the first line. The CSV importer is not limited to using a comma as the separator. Any character or string may be used. + + + +The CSV Import Dialog + + +The CSV Import Dialog + + + + +First, select the type of collection that you are importing. If you are appending or merging to your open collection, the type is limited to your current collection type. If the first line of the CSV file contains the field titles, click the check box and the importer will automatically compare the titles against the fields in the current collection. If a field title matches, the header for that column changes to show that the column has been assigned to that field. If the file uses a delimiter other than a comma, be sure to change that option accordingly. + + + +In order for &appname; to properly import the file, it must know which field corresponds to each column. If the column only has a number in the header, the data in that column will not be imported. You should assign fields to each column by selecting a column, either by clicking in it or changing the column number itself, then selecting the field to assign from the drop down box and clicking the Assign Field button. If you need to add a new field to the collection, the last item in the dropdown list opens the &fields-dialog;. + + + +Only the first five lines of the imported CSV file are shown in the dialog. + + + + + +Importing Audio CD Data + + +&appname; is able to use the freedb.org service to lookup +information about a CD, including the track list. Depending on your distribution, +settings for access to the service may be set in the &kde; Control Center. The CD artist, title, genre, +year, and track listing are all added. + + + +In addition, if the disc contains CD-Text, that information is read and added to the imported entry. + + + + +Importing Audio File Metadata + + +&appname; is able to scan a folder and read the tags for common audio file formats, such as mp3 and ogg. The songs are entered in a music collection, where each entry is an album. If the song files contain the track number, the song name is inserted in the correct spot in the track list. The artist and genre information is also added to the entry. If the song tags contain comments, they are appended to the comments field in the entry, preceded by the file name. + + + +In addition, if a folder contains a .directory file and the folder name matches an album title, the Icon entry in the desktop file is used as the cover image for the album. + + + +The audio file metadata importer can recursively scan a folder to find all audio files in any subfolder, though symbolic links are not followed. &appname; uses the TagLib library for reading the audio file metadata, and so can import data from any file type that TagLib understands. + + + + + +Importing Alexandria Libraries + + +Alexandria is an alternate book collection manager for the GNOME desktop environment. The importer offers a choice of importing any of the libraries found in $HOME/.alexandria/. + + + + + +Importing Ant Movie Catalog Data + + +Ant Movie Catalog is an alternate movie collection manager. + + + + + +Importing Bibtex Data + + +Bibtex is a bibliography format used with the LaTeX document preparation system. Various type of bibliographic references may be included in the file. &appname; imports bibtex files as a Bibliographic collection. + + + +If the bibtex importer encounters fields in the file which are not in the default bibliography collection, they are added as Simple Text fields, with two exceptions. If the field value contains more than 100 characters, it becomes a Paragraph field. If the field value appears to contain a &URL; or a file reference, then a URL field is created. &appname; uses an internal copy of the btparse library for parsing the bibtex files. + + + + +Importing Bibtexml Data + + +Bibtexml is an &xml; representation of bibtex data, and the data from the imported bibtexml file is treated in the same way as bibtex data would be. + + + + +Importing Delicious Library Data + + +Delicious Library is an alternate collection manager for the Mac OS X desktop. &appname; imports a subset of the data used by Delicious Library. + + + + +Importing GCstar Data + + +GCstar is an alternate collection manager. Importing books, movies, music, coins, games, board games and wine collections is currently supported. + + + +&appname; can also import GCfilms data files. GCfilms is the predecessor of GCstar and was an alternate movie collection manager. Normally, GCfilms data files are found in $HOME/.local/share/gcfilms/. + + + + + +Importing Griffith Data + + +Griffith is an alternate video collection manager. &appname; is able to import most data from a Griffith database. + + + + +Importing MODS Data + + +MODS is a format for representing various types of media collections. Currently, only books are imported by &appname;, as a Bibliographic collection. + + + + + +Importing PDF Data + +If &appname; was compiled with exempi or poppler support, metadata from PDF files can be imported. Metadata may include title, author, and date information, as well as bibliographic identifiers which are then used to update other information. + + + + +Importing RIS Data + +The RIS format is a bibliographic file format used by Reference Manager and others. &appname; imports RIS files as a Bibliographic collection. + + + + +Importing Referencer Data + +Referencer is a document organizer and bibliography manager for the GNOME desktop. &appname; will import most of the data found in a Referencer database. + + + + +Importing File Listings + + +The best way to create a File Catalog is to import the contents of a folder. The folder may be searched recursively, to add all files found within. This importer is most useful for backup listings and media cataloging, such as CD or DVD listings. In addition, image previews of the file contents may be generated, although it can take some time to read a large number of files. The file previews are same as those shown in the &kde; file manager. + + + + +Importing &xml; Data via XSLT + + +Any &xml; file may be imported into &appname; provided an XSL stylesheet is available to convert the file to &appname; format. &appname; automatically loads the stylesheet and performs the XSLT processing needed to load the file. + + + + + + +Drag and Drop + +Dragging data files to the main &appname; window and dropping them will import the files, just as if the import command was made from the menus. Drag and drop works for the following file formats: Tellico, Bibtex, RIS, and PDF. Importing multiple files at once is also supported. + +So, for example, if you want to catalog several PDF files, select them in the file manager and drag them to the &appname; window. &appname; will import as much metadata from the files as it can, and then fetch additional information from various configured Internet sources. + + + + +Exporting Data + + +When exporting the data in the collection, the entry values may be exported as entered, or with the automatic formatting provided by &appname;. Additionally, the export may be limited to the currently selected entries of the collection as well, where the statusbar shows the number of selected entries. + + + +Exported text files, such as Bibtex or CSV, may use the Unicode (UTF-8) character encoding, or the current locale of the operating system. + + + +General Export Options + + +General Export Options + + + + +Exporting &xml; + + +The file format for &appname; data is a zipped &xml; file. Exporting to &xml; merely creates the &xml; file without zipping it. Images may be included in the &xml; file as base64-encoded data in an image element, but doing so can create very large text files. + + + + +Exporting Zip + + +The standard file format for &appname; is a zipped file, contained the &xml; collection file, and optionally, all the images referenced in the collection. If the images are being stored in the application folder instead, exporting to a Zip file will create a self-contained data file, which includes all the images in the collection. + + + + +Exporting HTML + + +The HTML export uses the tellico2html.xsl stylesheet. Images are exported to a folder with the same name as the exported HTML file with _files appended. + + + +The default format is similar to the printed output, and allows various options for modifying the HTML. Field headers may be printed at the top of each column, but unfortunately, &kde; does not yet allow the table headers to be be repeated on each page. The entries may be grouped as in the &group-view;, as well. + + + +Additionally, individual files may be created for each entry in the collection, with links created in the top-level HTML file. The entry files will be created in the same folder as the images. The entry HTML files will use the current stylesheet template, as shown in the &entry-view;. + + + +HTML Export Options + + +HTML Export Options + + + + + +Exporting CSV + + +Comma-separated values (CSV) are a common way of importing and exporting tabular data. Each field value is separated by a comma, with one entry per line. The field titles may be included as headers in the first line. Any character or string other than a comma may also be used to delimit the fields. + + + +CSV Export Options + + +CSV Export Options + + + + + +Exporting Pilot-DB + + +Pilot-DB is a database format for Palm OS. Various desktop applications can read and write Pilot-DB files. Exported .pdb files can be transferred to a PDA, and used directly. At the moment, &appname; is not able to import Pilot-DB files. + + + +Pilot-DB Export Options + + +Pilot-DB Export Options + + + + + + +Exporting Alexandria + + +Alexandria is a book collection manager for the GNOME desktop environment. &appname; is able to export a limited subset of book collection fields to the default Alexandria data location. + + + + + +Exporting ONIX + + +ONIX is an XML format for representing and communicating book industry product information, primarily for book vendors. &appname; can export book collections using a small subset of ONIX. + + + + + +Exporting Bibtex + + +When exporting to Bibtex, the field values may be escaped with braces or quotation marks. If any string macros +are used in the collection, they may optionally be exported as macros or expanded. For &URL; fields, &appname; +may enclose the field values with the \url{...} tag. Finally, entries with no citation key may be skipped rather than have &appname; auto-generate the key. + + + +Bibtex Export Options + + +Bibtex Export Options + + + + + +Exporting Bibtexml + + +Bibtexml is a format for expressing bibtex data via XML. + + + + + +Exporting GCfilms + + +GCfilms is another movie collection manager. &appname; is able to export a limited subset of video collection fields to a GCfilms data file. + + + + + +Exporting &xml; via &xslt; + + +Finally, &appname; is able to process its internal &xml; representation of the collection data through an external XSL stylesheet before exporting. This type of export may be useful for generating text reports or other file types. + + + + + + +Working With Citations + +When working with a bibliography, citations for the currently selected entries +may be generated and used in various other applications. A citation in bibtex format can be copied to the clipboard, +and then pasted in a latex file. Bibtex citations can also be pushed to an external application such as LyX or Kile using the so-called lyxpipe. Finally, limited support is available for interacting with OpenOffice.org Writer. + + + +Working with OpenOffice.org + +&appname; has some limited support for sending citations to OpenOffice.org Writer and +updating the bibliography of a document. A special plugin is used, and if it is available, the menu command for +citing an entry in Writer is enabled. If it is not enabled, then &appname; is either +unable to find the plugin or is unable to load it. More information about building &appname; with +OpenOffice.org support is in a later section. + + + +OpenOffice.org must be configured to allow interaction from other applications. +There are two methods: named pipes and TCP/IP. Named pipes are the easier and faster. To run +Writer and connect with a named pipe, the following command may be used: + + +% oowriter "-accept=pipe,name=OOo_pipe;urp;StarOffice.ServiceManager" + + +The pipe or TCP/IP port can be configured to be open every time OpenOffice.org is used. Check +the OpenOffice.org documentation for more details. + + + +To insert a citation, select the entry, then use the Cite Entry in OpenOffice.org. +Writer must be running already. &appname; +will attempt to connect, and if it fails, it will ask for more information about the connection. + + + +OpenOffice.org Connection Dialog + + +OpenOffice.org Connection Dialog + + + + +Select the type of connection, either a pipe or a TCP/IP port. Enter the pipe name, or the hostname and port. +&appname; will remember your connection settings for later use. + + + + + + + diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..1f4eeb4 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,423 @@ + +Tellico'> + + + + + + + + + XML"> + XSLT"> + HTML"> + CSS"> + + Group View"> + Column View"> + Entry View"> + Entry Editor"> + Icon View"> + Collection Fields Dialog"> + Internet Search Dialog"> + Configuration Dialog"> + Find Dialog"> + Quick Filter"> + Advanced Filter Dialog"> + Loan Dialog"> + Report Dialog"> + Keyboard Shortcut Configuration Dialog"> + Toolbar Configuration Dialog"> + Filter View"> + Loan View"> + + + + + + + + + + + +]> + + + + + + + + + + + + +02/01/2008 +1.3 + +The &appname; Handbook + + + +Robby +Stephenson + +
&email;
+ + + + + + +2001 +2002 +2003 +2004 +2005 +2006 +2007 +2008 +&robby; + + + + + +Permission is granted to copy, distribute and/or modify this +document under the terms of the &GNU; Free Documentation License, +Version 1.1 or any later version published by the Free Software +Foundation; with &FDLInvariantSections;, with &FDLFrontCoverText;, and +with &FDLBackCoverText;. A copy of the license is included in +. + +The author of this documentation has also granted you permission to use +the content under the terms of the FreeBSD Documentation License, if you so choose. +See the notice in the licensing section. + + + + +This program is free software; you can redistribute it and/or +modify it under the terms of version 2 of the &GNU; General Public +License as published by the Free Software Foundation. + +This program is distributed in the hope that it will be +useful, but WITHOUT ANY WARRANTY; without even the implied warranty +of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the &GNU; +General Public License for more details. + +You should have received a copy of the &GNU; General Public +License along with this program; if not, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifh Floor, Boston, MA 02110-1301, USA. + + + + + + + +This document is a handbook for using &appname;, a collection manager software application. + + + + + + +KDE +tellico +book +bibliography +movie +collection +database +catalog + + + + + + + +Introduction + + + + +&appname; + + +&appname; is a program for managing collections. It began as a simple +book collection manager, and has expanded to include default +collection templates for bibliographies, comic books, videos, music, +coins, stamps, trading cards, video games, wines, board games, and file listings. +In addition, custom collections can be built for any other type of collectibles. + + + +What &appname; Is + + +&appname; keeps track of the items in a collection, and offers +an easy way to enter data for each entry. It provides several +field types, and allows for an unlimited number of +user-defined fields. The entries in a collection may be grouped by any +field for easy organization, and customizable views show as much or as +little information as you like. + + + +Loans may be tracked, with optional integration with &korganizer;. Collections may be +imported or exported using a variety of formats, to allow for easy exchange +or publication of data. + + + + + +What &appname; Is Not + + +&appname; is not an audio or video player. It does not provide +facilities for reading or modifying multimedia files. It also does +not provide any image-editing functionality. Although &appname; has some +functionality for managing bibliography lists, it is not a full-blown +bibliographic reference manager. &appname; also does not pretend to have +all the capabilities of a full-fledged relational database, + + + +As somewhat of a disclaimer, &appname; is a hobby for the author, and no +guarantees are made about its functionality, usefullness, or otherwise. It's +very far from being a professional software package. More information is included +in the license declaration. + + + + + + +Terminology + + +Collections + +In &appname;, a collection is the document. Only one collection exists in each &appname; +file. A collection contains any number of fields and +entries. &appname; supports 12 specific collection types by +default: books, bibliographic entries, comic books, videos, music, trading cards, coins, stamps, +video games, wines, board games, and file listings. In addition, an empty generic collection +template is available for any other type of collectibles or lists. + + + + +Collection Fields + +Each collection may have an unlimited number of fields. &appname; supports eleven types of fields, +which allow for a range of different data. The fields can be edited with the +&fields-dialog; and are explained further in the +Field Types section. + + + + +Collection Entries + + +An entry is the basic record in &appname;. Each entry contains a single value for each field in +the collection. A collection may have an unlimited number of entries, in theory, although since +the whole collection is always resident in memory, too many entries could slow down the application. + + + +&appname; has been tested with a collection of 10,000 entries, and the speed was satisfactory. +However, if many large images are included in the collection, the loading and processing time +does slow down greatly. Performance can be improved by having &appname; store images separate from +the data file itself, either in the application-specific directory or a directory relative to +the data file. More information can be found in the +configuration section. + + + + + + + + +&fundamentals-chapter; + +&details-chapter; + +&importing-exporting-chapter; + +&advanced-chapter; + +&configuration-chapter; + +&hacking-chapter; + +&faqs-chapter; + +&menus-chapter; + + + + + +Credits and License + + +&appname; + + +Program copyright 2001-2008 &robby; &email; + + +&underGPL; + + +Documentation copyright 2001-2008 &robby; &email; + + + + +This documentation is licensed under the terms of the &GNU; Free Documentation +License (GFDL). + +The author of this documentation has also granted you permission to use the content under the terms of the FreeBSD Documentation License, if you so choose. If you wish to allow use of your version of this content only under the terms of the FreeBSD Documentation License, and not to allow others to use your version of this file under the terms of the GFDL, indicate your decision by deleting the GFDL notice and and replacing it with the notice and other provisions required by the FreeBSD Documentation License. If you do not delete the GFDL notice above, a recipient may use your version of this file under the terms of either the GFDL or the FreeBSD Documentation License. + + + + +Installation + + +How to obtain &appname; + + +The &appname; home page can be found at +&homepage;. +Updates and news can be found there. + + + +Requirements + + + + +In order to successfully use &appname;, you need &kde; 3.3.1. +&appname; uses about 5 megabytes of memory to run, but this may vary +depending on your platform, configuration, and most of all, your collection size. + + + +&kde; can be found at the &kde; home page. + + + + +You can find a list of changes at &homepage;. + + + + +Compilation and Installation + + +In order to compile and install &appname; on your system, type the following +in the base folder of the archive, where the third step must be done as +root if you are installing in a system folder: + + +% ./configure +% make +% make install + + + +Since &appname; uses autoconf and automake you should not have +any trouble compiling it. Should you run into problems please report +them to the the author at &email;. + + +Compiling With OpenOffice.org + +&appname; uses a special plugin for communicating with OpenOffice.org, which is not compiled by default. +The Software Development Kit, available from +http://www.openoffice.org/dev_docs/source/sdk/, is required. + + +% ./configure =/usr/lib/openoffice =/usr/lib/openoffice/SDK + + +You'll need to use the correct locations of the OpenOffice.org libraries and SDK, of course. + + + +In addition, some distributions may require you to modify the /etc/ld.so.conf file +or add a configuration file to the /etc/ld.so.conf.d directory. Check +to see if the OpenOffice.org plugin works without any changes first. If it doesn't, try editing +/etc/ld.so.conf and adding the location of the OpenOffice.org libraries, the same as +you used for the configure script. +For additional help, use the &appname; Mailing List + + + + + + + +&documentation.index; + + + diff --git a/doc/en/loan-dialog.png b/doc/en/loan-dialog.png new file mode 100644 index 0000000..2bfd30d Binary files /dev/null and b/doc/en/loan-dialog.png differ diff --git a/doc/en/loan-view.png b/doc/en/loan-view.png new file mode 100644 index 0000000..a5c12bf Binary files /dev/null and b/doc/en/loan-view.png differ diff --git a/doc/en/main-window.png b/doc/en/main-window.png new file mode 100644 index 0000000..97e968f Binary files /dev/null and b/doc/en/main-window.png differ diff --git a/doc/en/menus.docbook b/doc/en/menus.docbook new file mode 100644 index 0000000..174eb6a --- /dev/null +++ b/doc/en/menus.docbook @@ -0,0 +1,768 @@ + +Command Reference + + + + +The Main &appname; Window + +Each menu item is discussed below. When there is a keyboard shortcut that +performs a menu item function, the default shortcut is listed with the menu item. + + + +The <guimenu>File</guimenu> Menu + + + + + + + + File + New + + + + +This command creates a new collection. &appname; supports 12 default collection types along with an empty user-defined custom collection. + + + + + + + + &Ctrl;O + + File + Open... + + + + +This command opens a &appname; file. + + + + + + + File + Open Recent + + + + +This command opens a file from a submenu +that contains a list of recently opened files. + + + + + + + + &Ctrl;S + + File + Save... + + + + +This command saves the collection. If the file is +Untitled then Save... is equivalent to +Save As. It is only enabled when the collection has been +modified. + + + + + + + File + Save As... + + + + +This command saves the collection to a new file. + + + + + + + + &Ctrl;P + + File + Print... + + + + +This command prints the collection. Printing options may be set in the &config-dialog;. + + + + + + + File + Import + + + + +This command imports data from another file. &appname; can import data from a number of other formats. + + + + + + + File + Export + + + + +This command exports the collection to another format. &appname; can export data to a number of other formats. + + + + + + + + &Ctrl;Q + + File + Quit + + + + +This command closes the &appname; window. If the collection has unsaved changes, you will be prompted to save them before continuing. + + + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + + + + + + + &Ctrl;Z + + Edit + Undo + + + + +This command undoes the previous action. Not all actions are supported by Undo. + + + + + + + + &Ctrl;&Shift;Z + + Edit + Redo + + + + +This command reverts a previous Undo.. + + + + + + + + &Ctrl;X + + Edit + Cut + + + + +This command removes the selected text, if any, and places a copy of the removed text in the clipboard. + + + + + + + + &Ctrl;C + + Edit + Copy + + + + +This command copies the selected text, if any, to the clipboard. + + + + + + + + &Ctrl;V + + Edit + Paste + + + + +This command pastes the text in the clipboard,if any, into the editor at the cursor position. + + + + + + + + &Ctrl;A + + Edit + Select All + + + + +This command selects all the entries in the collection, in the &detailed-view;. + + + + + + + + &Ctrl;&Shift;A + + Edit + Deselect + + + + +This command deselects all the entries in the collection. + + + + + + + Edit + Internet Search... + + + + +This command opens the &fields-dialog; to search for and import entries from various Internet sites, including Amazon.com. + + + + + + + + &Ctrl;J + + Edit + Advanced Filter... + + + + +This command opens the &filter-dialog;. + + + + + + + + + + +The <guimenu>Collection</guimenu> Menu + + + + + + + + + &Ctrl;N + + Collection + New Entry + + + + +This command opens the &entry-editor; to edit a new entry. + + + + + + + + &Ctrl;E + + Collection + Edit Entry + + + + +This command opens the &entry-editor; to edit the selected entries. + + + + + + + + &Ctrl;Y + + Collection + Duplicate Entry + + + + +This command copies, or duplicates, the selected entries as new entries in the collection. + + + + + + + + &Ctrl;D + + Collection + Delete Entry + + + + +This command deletes the selected entries. + + + + + + + Collection + Update Entry + + + + +This menu contains a list of all available data sources, and can be used to autmatically query the +source and update the selected entries. + + + + + + + Collection + Check-out. + + + + +This command opens a dialog box for loaning the selected entries.. + + + + + + + Collection + Check-in + + + + +This command checks-in any of the selected entries which are currently on-loan. + + + + + + + + &Ctrl;R + + Collection + Rename Collection + + + + +This command opens a dialog box for renaming the collection. + + + + + + + + &Ctrl;U + + Collection + Collection Fields... + + + + +This command opens the &fields-dialog;. + + + + + + + + &Ctrl;U + + Collection + Generate Reports... + + + + +This command opens the &report-dialog; for generating reports about the collection. + + + + + + + Collection + Convert to Bibliography + + + + +This command converts a book collection to a bibliography by adding certain fields necessary for Bibtex export, and it is only enabled when a book collection is open. + + + + + + + Collection + String Macros... + + + + +This command opens a dialog box for editing the Bibtex string macros in the collection. It is only enabled when editing a bibliography. + + + + + + + Collection + Copy Bibtex to Clipboard + + + + +This command copies a Bibtex citation to the clipboard so that it can pasted in a LaTeX document. + + + + + + + Collection + Cite Entry in Lyx + + + + +This command sends a citation for the selected entries to the so-called lyxpipe for use in LyX, Kile, or other LaTeX applications. It is only enabled when editing a bibliography. + + + + + + + Collection + Cite Entry in OpenOffice.org + + + + +This command sends a citation for the selected entries to OpenOffice.org Writer. It is only enabled when editing a bibliography when the OpenOffice.org plugin is available. + + + + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + + + + + Settings + Toolbars + + + + +This command toggles the display of the toolbars. + + + + + + + Settings + Show Statusbar + + + + +This command toggles the display of the statusbar. + + + + + + + Settings + Show &group-view; + + + + +This command toggles the display of the &group-view;. + + + + + + + Settings + Show &entry-editor; + + + + +This command toggles the display of the &entry-editor;. + + + + + + + Settings + Show &entry-view; + + + + +This command toggles the display of the &entry-view;. + + + + + + + Settings + Group Selection + + + + +This command changes the field used to group the entries in the collection. + + + + + + + Settings + Configure Shortcuts... + + + + +This command opens the the &kde; &shortcut-dialog;. + + + + + + + Settings + Configure Toolbars... + + + + +This command opens the the &kde; &toolbar-dialog;. + + + + + + + Settings + Configure &appname;... + + + + +This command opens the &appname; &config-dialog;. + + + + + + + + + +The <guimenu>Help</guimenu> Menu + + + + + + + + Help + &appname; Handbook + + + + +This command opens the &appname; Handbook. + + + + + + + + &Shift;F1 + + Help + What's This? + + + + +This command changes the mouse cursor to an arrow with a question mark. Clicking on items in the window will show a small tooltip (if one exists for that item) explaining what the item does. + + + + + + + Help + Tip of the Day + + + + +This command opens the Tip of the Day dialog. You can page through all the tips by using the buttons on the dialog. + + + + + + + Help + Report Bug... + + + + +This command open the Submit Bug Report dialog. If you find +a bug or a problem, if you have a suggestion for improvement, or a translation correction, use this interface to send the author an email. + + + + + + + Help + About &appname; + + + + +This command opens the About &appname; dialog, showing version and author information for the application. + + + + + + + Help + About &kde; + + + + +This command opens the About &kde; dialog, showing the &kde; version and other information about the desktop environment. + + + + + + + + + + diff --git a/doc/en/openoffice-dialog.png b/doc/en/openoffice-dialog.png new file mode 100644 index 0000000..0618807 Binary files /dev/null and b/doc/en/openoffice-dialog.png differ diff --git a/doc/en/print-options.png b/doc/en/print-options.png new file mode 100644 index 0000000..03dd7a3 Binary files /dev/null and b/doc/en/print-options.png differ diff --git a/doc/en/report-dialog.png b/doc/en/report-dialog.png new file mode 100644 index 0000000..ff6cbe0 Binary files /dev/null and b/doc/en/report-dialog.png differ diff --git a/doc/en/source-options.png b/doc/en/source-options.png new file mode 100644 index 0000000..eac74ab Binary files /dev/null and b/doc/en/source-options.png differ diff --git a/doc/en/sru-options.png b/doc/en/sru-options.png new file mode 100644 index 0000000..a1a649a Binary files /dev/null and b/doc/en/sru-options.png differ diff --git a/doc/en/template-options.png b/doc/en/template-options.png new file mode 100644 index 0000000..f805d73 Binary files /dev/null and b/doc/en/template-options.png differ diff --git a/doc/en/z3950-options.png b/doc/en/z3950-options.png new file mode 100644 index 0000000..5650ba1 Binary files /dev/null and b/doc/en/z3950-options.png differ diff --git a/doc/fr/CMakeLists.txt b/doc/fr/CMakeLists.txt new file mode 100644 index 0000000..8e5d934 --- /dev/null +++ b/doc/fr/CMakeLists.txt @@ -0,0 +1,60 @@ +INCLUDE_DIRECTORIES( ${CMAKE_CURRENT_SOURCE_DIR} ${CMAKE_CURRENT_BINARY_DIR} ${KDE3_INCLUDE_DIR} ${QT_INCLUDE_DIR} ) + + +########### install files ############### + + + + +#original Makefile.am contents follow: + +######## kdevelop will overwrite this part!!! (begin)########## +# +# +#EXTRA_DIST = \ +#advanced.docbook \ +#configuration.docbook \ +#details.docbook \ +#faqs.docbook \ +#fundamentals.docbook \ +#hacking.docbook \ +#importing-exporting.docbook \ +#index.docbook \ +#menus.docbook \ +#freebsd-doc-license.html \ +#entry-editor1.png \ +#entry-editor3.png \ +#entry-editor4.png \ +#entry-editor5.png \ +#fields-dialog.png \ +#general-options.png \ +#main-window.png \ +#print-options.png \ +#template-options.png \ +#source-options.png \ +#filter-dialog.png \ +#csv-dialog.png \ +#fetch-dialog.png \ +#export-options.png \ +#export-html.png \ +#export-csv.png \ +#export-pdb.png \ +#export-bibtex.png \ +#amazon-options.png \ +#z3950-options.png \ +#externalexec-options.png \ +#report-dialog.png \ +#loan-dialog.png \ +#loan-view.png \ +#filter-view.png \ +#openoffice-dialog.png \ +#sru-options.png \ +#imdb-options.png +# +# +######## kdevelop will overwrite this part!!! (end)############ +# +#KDE_LANG = fr +#KDE_DOCS = tellico +# +#CLEANFILES = *~ diff --git a/doc/fr/Makefile.am b/doc/fr/Makefile.am new file mode 100644 index 0000000..0d55385 --- /dev/null +++ b/doc/fr/Makefile.am @@ -0,0 +1,50 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +EXTRA_DIST = \ +advanced.docbook \ +configuration.docbook \ +details.docbook \ +faqs.docbook \ +fundamentals.docbook \ +hacking.docbook \ +importing-exporting.docbook \ +index.docbook \ +menus.docbook \ +freebsd-doc-license.html \ +entry-editor1.png \ +entry-editor3.png \ +entry-editor4.png \ +entry-editor5.png \ +fields-dialog.png \ +general-options.png \ +main-window.png \ +print-options.png \ +template-options.png \ +source-options.png \ +filter-dialog.png \ +csv-dialog.png \ +fetch-dialog.png \ +export-options.png \ +export-html.png \ +export-csv.png \ +export-pdb.png \ +export-bibtex.png \ +amazon-options.png \ +z3950-options.png \ +externalexec-options.png \ +report-dialog.png \ +loan-dialog.png \ +loan-view.png \ +filter-view.png \ +openoffice-dialog.png \ +sru-options.png \ +imdb-options.png + + +####### kdevelop will overwrite this part!!! (end)############ + +KDE_LANG = fr +KDE_DOCS = tellico + +CLEANFILES = *~ diff --git a/doc/fr/advanced.docbook b/doc/fr/advanced.docbook new file mode 100644 index 0000000..54f04b7 --- /dev/null +++ b/doc/fr/advanced.docbook @@ -0,0 +1,120 @@ + +Utilisation avancée + + +Options en ligne de commande + + +Lorsque vous exécutez &appname; depuis la ligne de commande, il existe plusieurs +options pour ouvrir des fichiers de données. Ces options peuvent être vues en +exécutant tellico --help. + + + +Usage: tellico [Qt-options] [KDE-options] [options] [filename] + +Tellico - a collection manager for KDE + +Options: + --nofile Do not reopen the last open file + --bibtex Import <filename> as a bibtex file + --mods Import <filename> as a MODS file + --ris Import <filename> as a RIS file + +Arguments: + filename File to open + + + + + +Interface &DCOP; + + +&appname; dispose d'une interface &DCOP; minimale, qui peut être utilisée pour +automatiser l'application ou interagir avec depuis une la ligne de commande. +Co,,e pour tous les appels &DCOP;, vous devez spécifier l'application avec +laquelle vous souhaitez interagir ; ainsi que l'interface spécifique. Les appels +&DCOP; décris dans ce document sont tous disponibles dans l'interface +tellico de &appname; ; alors que le nom de l'application +est tellico-pid, où pid est le +process id de l'application. + + + +Commandes DCOP + + +La liste complète des commandes &DCOP; de l'objet tellico +est disponible ci-dessous : + + + +bool importTellico(QString file, QString action) +bool importBibtex(QString file, QString action) +bool importMODS(QString file, QString action) +bool importRIS(QString file, QString action) +bool exportXML(QString file) +bool exportBibtex(QString file) +bool exportHTML(QString file) +bool exportCSV(QString file) +bool exportPilotDB(QString file) +QStringList bibtexKeys() + + + +Pour les quatre commandes d'import, le premier paramètre est le nom du fichier +à importer, et le second l'action lors de l'import. Trois types d'actions sont +disponibles : replace (remplacer), +append (ajouter) et merge (fusioner). +Quatre formats de fichier sont possibles pour l'import : fichier XML Tellico, +BibTeX, MODS et RIS. + + + +La collection ouverte dans &appname; peut être exportée vers un fichier, dans +le format XML de Tellico, BibTeX, HTML ou CSV. + + + +Enfin, si la collection courante est un bibliographie, appeler +bibtexKeys() donnera comme résultat la clef de citation +BibTeX de toutes les entées sélectionnées. + + + + + +Exemples DCOP + + +Voici quelques exemples de scripts &appname; utilisant l'interface &DCOP;. +Puisque le pid doit être connu, la façon la plus simple de +l'inclure dans la commande shell suivante : +dcop $(dcop | grep tellico) tellico. + + + +Ouvrir un fichier BibTeX +% +dcop $(dcop | grep tellico) tellico importBibtex ~/documents/reference.bib replace +true + + + +Exporter un fichier BibTeX +% dcop $(dcop | grep tellico) tellico exportBibtex ~/documents/reference.bib +true + + + +Afficher la clef de citation de la sélection courante +% dcop $(dcop | grep tellico) tellico bibtexKeys +stephenson2004 + + + + + + + diff --git a/doc/fr/amazon-options.png b/doc/fr/amazon-options.png new file mode 100644 index 0000000..2f7d673 Binary files /dev/null and b/doc/fr/amazon-options.png differ diff --git a/doc/fr/configuration.docbook b/doc/fr/configuration.docbook new file mode 100644 index 0000000..dc65eb6 --- /dev/null +++ b/doc/fr/configuration.docbook @@ -0,0 +1,445 @@ + +Configuration + + + +La Boite de dialogue de configuration contient toutes +les options pour changer certains comportements par défaut de &appname;. + + + +Cliquer sur le bouton Appliquer +applique les modification immédiatement, +sans fermer la boite de dialogue, alors que le bouton OK +applique les changements et ferme la boite de dialogue. +Annuler ferme la boite de dialogue ; mais toutes les +modifications déjà appliquées seront conservées. +Le bouton Défaut rétablit les options +de la page courante de la boite de dialogue à leurs valeurs par défaut, alors +que Aide ouvre &khelpcenter; à la +section relative du manuel de &appname;. + + + +Certains paramètres ne peuvent être modifiés qu'en éditant le fichier de +configuration à la main. Voir les +Options de configuration cachées. + + + +<guilabel>Options Générales</guilabel> + + +Les options générales + + +La boite de dialogue d'options générales + + + + +La boite de dialogue des options générales contrôle le +comportement global. Les images peuvent être incluses dans le fichier de +données ; ou enregistrées dans le répertoire de &appname;. De plus, lorsque +&appname; est démarré, il peut automatiquement ouvrir le dernier fichier ouvert. +La boite de dialogue de l'astuce du jour contient des +astuces utiles sur l'utilisation de &appname; et apparaît au démarrage du +programme. Vous pouvez lire quelques astuces puis désactiver la boite de +dialogue. + + + +Les options de mise en forme contrôlent le niveau de mise +en forme automatique effectué par &appname;. Des exemples sont disponibles dans +la sectionMise en forme des champs. +La mise en majuscules et la mise en forme sont des options distinctes, un champ +pouvant être mis en majuscules sans que l'ordre des mots soit changé et +inversement. La mise en forme automatique inclut les articles dans les titres, +ainsi que les préfixes et suffixes des noms propres. Les valeurs sont +insensibles à la casse et doivent être séparées par un point)virgule. + + + +Les règles de mise en forme suivent les standards anglais et peuvent être +incompatibles avec d'autres langues. Les articles sont déplacés à la fin du +titre, précédés d'une virgule. Les noms propres sont transformés pour placer +le nom propre en premier, suivi d'une virgule et du prénom. Les suffixes, tels +que Jr., sont conservés avec le nom propre. Les particules, telles que +von ou de, sont conservées avec le +nom propre ; mais sont ignorées lorsque les noms sont triés. + + +John Q. von Public, III +deviendrait von Public, III, John Q. ; et +Public serait utilisé pour le tri. + + +Seuls les particules en un seul mot sont gérées. Si un nom inclut +de la, par exemple, de et +la doivent être inclus dans la liste des particules. +Les articles se finissant par une apostrophe sont également gérés pour le tri. + + +Les données réelles contenues dans la collection +ne sont pas modifiées, seul le texte affiché est affecté. +Ainsi, les options de mise en forme peuvent être modifiées sans altérer les +données de la collection. + + + + +<guilabel>Options d'impression</guilabel> + + +&appname; utilise une feuille de style &xslt; pour générer du &html; ; puis le +transmet au service d'impression de &kde;. Seuls les champs visibles dans la +&detailed-view; sont imprimés. De plus, si +la collection a des filtres appliqués, seules les entrées visibles sont +imprimées. Un message d'avertissement est affiché si un filtre est actif. + + + +La boîte de dialogue des options d'impression + + +La boîte de dialogue des options d'impression + + + + +Les Options d'impression vous permettent de modifier +certains aspects de la mise en forme lorsque vous imprimez une collection. +Si Mettre en forme les titres et noms est coché, les champs +sont mis en forme automatiquement. +Dans le cas contraire, elles sont imprimées telles qu'elles ont été saisies. + + + +La feuille de style d'impression par défaut affiche les valeurs des champs en +colonnes. Imprimer les en-têtes des champs contrôle si les +titres des champs sont imprimés au sommet des colonnes. + + + +A l'impression, les entrées sont triées de la même manière que dans la +&detailed-view;. Cependant, elles peuvent +être groupées selon la &group-view; à la place +en utilisant l'option Grouper les entrés. + + + +Enfin, lorsque les champs contenant des images sont inclus à l'impression, les +images peuvent être re-dimensionnées, tout en conservant leur rapport +largeur/hauteur. La largeur et la hauteur maximales définissent les dimensions +à ne pas dépasser, une image n'étant jamais agrandie. + + + + +<guilabel>Options des modèles</guilabel> + + +La &entry-view; utilise des modèles pour +afficher les valeurs des champs. Vous pouvez définir un modèle différent pour +chaque type de collection. Certains modèles, tels que ceux définis pour les +Albums ou les Vidéos sont spécifiques +à un type de collection donné ; et un message d'erreur apparaîtra dans la +&entry-view; s'ils sont utilisés pour d'autres types de collections. + + + +Les modèles additionnels peuvent être installés dans +$KDEHOME/share/apps/tellico/entry-templates/. + + + +La boîte de dialogue des options de modèles + + +La boîte de dialogue des options de modèles + + + + + + +<guilabel>Options des sources d'informations</guilabel> + + +&appname; peut utiliser différentes sources pour importer des données, qui +peuvent être configurées dans la boîte de dialogue des sources d'informations. +Différents types de sources sont disponibles : + + + +Web Services Amazon.com, +Internet Movie Database 9, +Serveurs z39.50, +Serveurs SRU, +Bases de données Entrez (PubMed), +Yahoo! Audio Search, +AnimeNfo.com, +Internet Bookshop Italia, +ISBNdb.com, +Allociné.fr, +Le Ministère de la culture espagnole, +Dark Horse Comics, +D'autres scripts ou applications externes + + + +La boîte de dialogue des sources d'informations + + +La boîte de dialogue des sources d'informations + + + + +De nouvelles sources peuvent être ajoutées en cliquant sur le bouton +Ajouter.... Celles existantes peuvent aisément être +modifiées ou supprimées, à l'aide des boutons Modifier... +Supprimer. + + + +Certaines sources d'informations contiennent plus d'informations que les champs +par défaut de &appname;. Ces autres champs sont affichés sur la droite de la +boîte de dialogue. Si l'un de ces champs est coché, il est alors ajouté à la +collection lorsqu'une entrée de cette source est ajoutée. + + + +Amazon.com + + +En utilisant les Services Web Amazon, &appname; peut chercher des informations +sur six différents sites internationaux gérés par +Amazon.com : États Unis, Royaume Uni, +Allemagne, Japon, France et Canada. + + + + + + + + + +Configurer chaque source Amazon.com nécessite trois paramètres : l'adresse du +serveur, la taille de l'image et l'ID de l'associé. Certaines informations de +Amazon.com contiennent une image, telle +que la couverture d'un livre ou la jaquette d'une vidéo. Cette image peut être +télé-chargée en trois différentes tailles, en fonction du produit. Pour éviter +qu'un trop grand nombre d'images ralentisse l'application, les images moyennes +ou grandes ne sont pas recommandées. L'ID de l'associé doit être utilisée pour +accéder aux Services Web Amazon.com et sont inclus dans les liens vers les +produits, en accord avec les conditions d'utilisation des Services Web +Amazon.com. + + + + + +Base de données de films sur Internet (IMDb) + + +La base de données de films sur Internet (IMDb) +fournit des informations à propos des films et des vidéos. Quand une recherche +est faite pour une personne, si plus d'un résultat est +retourné, une boîte de dialogue est ouverte pour vous permettre de choisir la +bonne référence. Les options de configuration concernent l'adresse du serveur +web et si les images doivent être télé-chargées ou non. IMDb pouvant donner un +nombre important de participants à un film, vous pouvez limiter ce nombre. + + + + + + + + + + + +Serveurs z39.50 + + +Le protocole z39.50 +est utilisé pour accéder à des bibliothèques et des fournisseurs d'informations +bibliographiques à travers le Monde. Des listes de serveurs z39.50 publics sont +disponibles sur indexdata.dk, +entre autres. &appname; peut accéder à tous les serveurs z39.50 fournissant des +données dans les formats MODS, +USMARC/MARC21, ou +UNIMARC, en utilisant la +bibliothèque yaz. +Une gestion limitée du format GRS-1 est également disponible. + + + + + + + + + +Le port par défaut pour accéder à un serveur z39.50 est 210, mais certains +serveurs peuvent en utiliser un différent. &appname; considère que le serveur +utilise l'encodage de caractères MARC-8, sauf s'il est configuré autrement. Si +un encodage de caractères incorrect est utilisé, un message d'erreur peut être +affiché, ou l'import peut ne donner aucun résultat. + + + +Certains serveurs nécessitent un nom d'utilisateur et un mot de passe pour y +accéder. &appname; peut utiliser et sauvegarder ce mot de passe ; mais soyez +conscient qu'il sera écrit en clair dans le fichier de configuration de +&appname; et ne sera pas en sécurité. Pour la plupart des serveurs publics, le +nom d'utilisateur et le mot de passe peut être laissé vides. + + + + + +Serveurs SRU + + +SRU signifie +Search/Retrieve via URL. +Il d'un protocole de recherche pour Internet. Certaines bibliothèques +l'utilisent pour permettre l'accès à leurs catalogues de données. Parmi +celles-ci, la +bibliothèque du congrès américain +est probablement la plus connue. + + + + + + + + + + + +Bases de données Entrez + +Entrez est un système +de recherche et de récupération d'informations, utilisé au centre national +d'information sur la biotechnologie américain (National Center for +Biotechnology Information, NCBI). La base de données Entrez la plus connue est +PubMed, +la base de données d'articles sur les sciences de la vie pour de nombreux +journaux traitant de biologie. Pour le moment, la seule base de données Entrez +gérée par &appname; est PubMed. + + + + +Recherche Yahoo! Audio + +Le service de recherche +Yahoo! Audio peut être +utilisé pour chercher les informations sur les albums de musique. + + + + +AnimeNfo.com + +AnimeNfo est un site populaire +d'informations sur l'animation japonaise. + + + + +Internet Bookstore Italia + +IBS, ou Internet Bookstore Italia, est un +magasin en ligne italien, vendant des livres. + + + + +ISBNdb.com + +ISBNdb.com est une base de données en +ligne de livres, comprenant des informations provenant de plusieurs pays. + + + + +Allociné.fr + +Allociné.fr est une base de données +française en ligne de filme. Cette source +fonctionne sous la forme d'un script et +nécessite l'installation de Python. + + + + +Ministre espagnol de la culture + +Le Ministre espagnol de la culture est +une base de données en ligne espagnole de livres. Cette source +fonctionne sous la forme d'un script et +nécessite l'installation de Python. + + + + +Dark Horse Comics + +Dark Horse Comics est une éditeur de +bandes dessinées. Cette source +fonctionne sous la forme d'un script et +nécessite l'installation de Python. + + + + +Scripts ou applications externes + +Pour importer plus facilement des données externes dans &appname;, il est +possible d'utiliser des scripts ou applications externes en tant qu'interfaces +de recherche. &appname; exécute une commande, et passe les termes recherchés en +tant que paramètres de ligne de commande. + + + + + + + + + +Le type de collection renvoyé par le script soit être configuré, ainsi que le +format de données. Non seulement &appname; peut importer des données de scripts +utilisant le +format &xml; de &appname; par défaut ; mais +il peut également gérer d'autres formats tels que BibTeX. + + + +Le chemin complet de l'application doit être entré dans les options de source. +L'application est exécutée avec les droits de l'utilisateur en cours, prenez +donc garde à ne pas utiliser de script d'origine inconnue. Vérifiez que les +boîtes à côté des clefs de recherche sont bien gérées par l'application, et +entrez les options de la ligne de commande.La valeur cherchée est insérée à la +place de %1. + + + +Pour mettre à jour des entrées déjà dans la collection, les dernières à cocher +et de saisie de texte sont utilisées pour déterminer les options de ligne de +commande. Les champs de l'entrée utilisés pour trouver une mise à jour doivent +être saisis dans le même format que les champs de type +Dépendant. + + + + + + diff --git a/doc/fr/csv-dialog.png b/doc/fr/csv-dialog.png new file mode 100644 index 0000000..9b04388 Binary files /dev/null and b/doc/fr/csv-dialog.png differ diff --git a/doc/fr/details.docbook b/doc/fr/details.docbook new file mode 100644 index 0000000..f49df7c --- /dev/null +++ b/doc/fr/details.docbook @@ -0,0 +1,613 @@ + +Détails de &appname; + + +Types de champs + + +Chaque collection peut avoir un nombre illimité de champs. &appname; gère +onze types de champs, permettant une large variété de données différentes. + + + +Texte simple + + +Le type de champ de base est appelé Texte Simple. Aucune +restrictions ne s'applique aux valeurs, et l'élément d'édition est une simple +ligne. Ce type convient aux champs destinés à ne pas contenir de long texte, +tels que l' auteur ou le genre d'un livre. + + + + +Nombre + + +Le type Nombre est identique au +Texte simple, mais le contenu est restreint aux valeurs +numériques. Les entrées seront triées par ordre numérique croissant si l'on +clique sur l'en-tête d'un champ de type Nombre. La ligne +d'éditions classique est utilisée, avec des flèches pour augmenter ou diminuer +la valeur. Aucune mise en forme n'est appliquée. + + + + + +&URL; + + +Le type &URL; permet d'inclure un lien vers un autre +document, en utilisant l'association au type de fichier de &kde; pour l'ouvrir. +Aucune vérification n'est effectuée sur le contenu d'un champ +&URL; ; mais les liens non valides ne sont pas ouverts. +L'élément de saisie est une ligne d'édition avec un bouton pour ouvrir la boîte +de dialogue standard d'ouverture de fichier ; mais tout type d'&URL; peut être +utilisé. Les &URL; relatives sont interprétées par rapport au chemin du fichier +de données, une fois qu'il a été enregistré. + + + +Dans l'&entry-editor;, le texte devient un +lien ; alors que dans la &entry-view;, un +hyperlien classique est utilisé. Ce type de champ convient pour lier à des +fichiers PDF pour des entrées bibliographiques ou des +critiques de film par exemple. Aucune mise en forme n'est appliquée. + + + +Des &URL; relatives peuvent également être utilisées. Elles sont interprétées +par rapport au chemin du fichier de données &appname;. Dans +l'&entry-editor;, la ligne d'édition +permet l'auto-complétion pour les fichiers locaux. Si vous souhaitez que +l"&URL; fournie par le sélecteur de fichiers &kde; soit interprétée de façon +relative par rapport au fichier &appname;, ajoutez une propriété étendue pour +le champ &URL; avec comme valeurs +relative : true. + + + + + +Paragraphe + + +Pour les textes plus longs, le type Paragrapheoffre une +zone d'édition plus importante, dans sa propre catégorie. Un champ de type +Paragraphe ne peut être à multiples values, ni mis en +forme automatiquement. Il ne peut pas être utilisé pour le regroupement. +Les résumée, introductions et critiques devraient être saisies dans ce type de +champ. + + + + + +Choix + + +Quand un champ doit être limité à quelques valeurs pré-sélectionnées, un champ +de type Choix est utilisé. Les valeurs possibles sont +présentées dans une liste déroulante. Évidement, le principe des valeurs +multiples ne s'applique pas à ce type de champ. Les champs tels que le type +de bibliographie ou de notation sont de type Choix. + + +Des point-virgules doivent être utilisés pour séparer les valeurs +possibles. + + + + +Case à cocher + + +Pour les champs prenant seulement comme valeurs oui ou non, le type +Case à cocher est disponible. Par défaut, la case n'est +pas cochée. Le champ n'est bien entendu pas mis en forme et est limité à une +seule valeur. En interne, les valeurs sont enregistrées en tant que +true et +false. Les champs "offert" et "prêté" +sont de ce type. + + + + +Date + + +Un champ de type Date peut inclure jour, mois et année. +La date est affichée au format AAAA-MM-JJ, qui permet de les trier facilement. +Le sélecteur de date &kde; peut être utilisé pour choisir la date à la souris, +ou celle)ci peut être entrée à la main. Les trois champs jour, mois et année +peuvent être vide. Il n'est bien sûr pas possible d'avoir des valeurs +multiples. + + + + + +Tableau + + +Les champs de type Tableau contienent une ou plusieurs +colonnes de valeurs. Dans l'&entry-editor;, +le champ se présente comme un tableur avec des lignes numérotées. Lorsque la +dernière ligne est sélectionnée, une ligne supplémentaire est ajoutée. +L'auto-complétion n'est pas disponible. Ce champ est utile pour la liste des +chapitres d'un livre, des scènes d'un livre ou des titres d'un album. Les +champs de type Tableau sont toujours dans leur propre +catégorie. + + + +Le nombre de colonnes, un maximum de dix, est défini en ajoutant une propriété +à la définition du champ avec le nom columns. Il est +possible de leur attribuer un titre en cliquant du bouton droit sur l'en-tête, +ou en ajoutant une propriété au champ de type column1, +etc. + + + +Lors de l'utilisation de l'&entry-editor; pour les champs de type +Tableau, les lignes peuvent être réordonnées en les +déplaçant avec la souris tout en maintenant le bouton &Ctrl;. Un menu est +également disponible en cliquant du bouton droit sur le tableau, qui permet +d'insérer ou supprimer des lignes. + + + + + +Image + + +Un champ de type Image contient une image, dans un format +reconnu par &kde;, tel que PNG ou JPEG. +L'image peut être enregistrée dans le fichier de données &appname; lui-même ou +dans le répertoire de données de l'application. Le sélecteur de fichiers &kde; +est utilisé, donc vous pouvez utiliser une &URL; ou un fichier local. Les images +peuvent également être glissée depuis un gestionnaire de fichiers ou un +navigateur. + + + + + +Note + + +Les champs de type Note affichent un nombre d'étoiles +représentant la note numérique d'une entrée. Par défaut, la note maximale est +cinq. Le minimum et le maximum peuvent être configurées dans la &fields-dialog;, +en ajoutant les propriétés minimum et +maximum. + + + + + +Dépendant + + +Le dernier type de champ est le type Dépendant, que vous +n'utiliserez probablement pas souvent. Il est utilisé pour combiner les valeurs +d'autres champs en utilisant les valeurs des descriptions de champs. Par +exemple, si un champ de type Dépendant a comme description +%{title} %{year}, la valeur de ce champ sera le titre +suivi de l'année. Ce type de champ est principalement pour le titre dans les +collections de monnaies, timbres, cartes et vins. Le nom interne ou le titre +de champ peut être utilisé dans la description pour la mise en forme. + + + + + + +Types de collections + + +&appname; gère onwe types de collections par défaut : livres, entrées +bibliographiques, bandes dessinées, vidéos, musique, jeux vidéo, cartes, +monnaie, timbres, vins; jeux de plateau et catalogues de fichiers. De plus, un modèle de +collection générique est disponible pour tout autre type d'objet à +collectionner. Les collections sont uniquement présentes pour inclure un jeu de +champs, vous pouvez en ajouter, modifier et effacer pour l'adapter à vos +besoins. La seule obligation est qu'une collection doit toujours avoir un champ +Titre, pour que la +&group-view; puisse fonctionner +correctement. Pour certains types de collections, il s'agit seulement d'un champ +Dépendant combinant les +valeurs d'autres champs. + + + +Il n'y a pas de différence fonctionnelle entre les types de collections. Vous +pourriez créer une collection personnalisée pour vos livres aussi facilement +qu'en utilisant la collection de livres par défaut. Cependant, &appname; choisit +les icônes en en fonction du type de collection et certaines fonctionnalités +peuvent être spécifiques à certaines collections ; donc si vous le pouvez, il +est recommandé d'utiliser les types par défaut. Par exemple, si vous souhaitez +créer une collection de vins mais n'aimez pas les champs par défaut, créez une +collection par défaut et modifiez les champs. De cette façon, &appname; sait +qu'il s'agit d'une collection de vins. + + + +Collections de livres + +Les collections de livres ont 26 champs par défaut. +Titre, +Sous-titre, +Auteur, +Reliure, +Date d'achat, +Prix d'achat, +Éditeur, +Édition, +Année du copyright, +Année de publication, +ISBN#, +LCCN#, +Pages, +Langue, +Genre, +Mots clef, +Série, +Numéro, +État, +Signé, +Lu, +Offert, +Prêté, +Note, +Couverture, et +Commentaires. + + + +Le champ ISBN# est spécial, les numéros +ISBN étant automatiquement mis en forme et leur chiffre de +vérification calculé. +&appname; reconnaît un champ ISBN si son nom interne est +isbn. Si vous l'effacez ou souhaitez l'ajouter à un autre +type de collection, créez un champ avec comme titre ISBN, +appliquez la modification, puis donnez-lui le titre désiré. &appname; crée le +nom interne en fonction du titre initial ; mais ne le met pas à jour en cas de +changement. + + + + + +Bibliographies + +Les Bibliographies ont 22 champs par défaut. +Titre, +Type d'entrée, +Auteur, +Clef BibTeX, +Titre du livre, +Éditeur, +Organisation, +Publié par, +Adresse, +Édition, +Pages, +Année, +Journal, +Mois, +Numéro, +Publié, +Chapitre, +Série, +Volume, +Référence croisée, et +Notes. + + + +Bien que les collections bibliographiques ne soient pas spécifiquement liées à +BibTeX, les champs par défaut sont ceux habituellement trouvés dans BibTeX. +Lors de l'export au format BibTeX, une propriété étendue appelée +bibtex est utilisée pour chaque champ afin de définir le +champ BibTeX correspondant. Si vous ajoutez un champ supplémentaire et souhaitez +le voir exporté vers BibTeX, assurez-vous qu'il dispose bien de la propriété +étendue bibtex. + + + +&appname; dispose de certaines fonctions spécifiques aux bibliographies. Des +macros BibTeX peuvent être ajoutées, modifiées ou effacées depuis &appname; ; +et l'export au format BibTeX vous donne la possibilité d'appliques les macros. +Les citations BibTeX peuvent être transmises à une application externe telle +que LyX ou Kile, à l'aide + de ce qu'on appelle des +lyxpipe. + + + +Les collections de livres peuvent être converties en bibliographies. Les champs +liés à BibTeX sont alors ajoutés, et les propriétés étendues configurées. Cette +fonctionnalité existe principalement pour convertir les anciennes collections, +avant que le type "bibliographie" soit séparé de celui "collection de livres. + + + + +Collections de bandes dessinées + +Les collections de bandes dessinées ont 22 champs par défaut. +Titre, +Sous-titre, +Auteur, +Artiste, +Collection, +Numéro, +Éditeur, +Édition, +Année de publication, +Pages, +Pays, +Langue, +Genre, +Mots clef, +État, +Date d'achat, +Prix d'achat, +Signé, +Offert, +Prêté, +Couverture, et +Commentaires. + + + + + +Collections de vidéos + +Les collections de vidéos ont 30 champs par défaut. +Titre, +Support, +Année de production, +Certification, +Genre, +Région, +Nationalité, +Format, +Acteurs, +Réalisateur, +Producteur, +Auteur, +Compositeur, +Studio, +Langues disponibles, +Langues des sous-titres, +Plages audio, +Durée, +Format, +Écran large, +Couleurs, +Version du réalisateur, +Trame, +Note personnelle, +Date d'achat, +Prix d'achat, +Offert, +Prêté, +Jaquette, et +Commentaires. + + + +Le champ Acteurs est un table +à deux colonnes, avec en principe le nom de l'acteur dans la première colonne +et son rôle dans la seconde. La Durée est supposée être en +minutes ; mais vous pouvez bien entendu changer cela. + + + + +Collections musicales + +Les collections musicales ont 15 champs par défaut. +Titre, +Support, +Artiste, +Label, +Année, +Genre, +Pistes, +Note, +Date d'achat, +Prix d'achat, +Offert, +Prêté, +Mots clef, +Jaquette, et +Commentaires. + + + + + +Collections de jeux + +Les collections de jeux vidéos ont 16 champs par défaut. +Titre, +Plateforme, +Genre, +Année de parution, +Éditeur, +Développeur, +ESRB Rating, +Description, +Note personnelle, +Terminé, +Date d'achat, +Prix d'achat, +Offert, +Prêté, +Couverture, et +Commentaires. + + + + + +Collections de cartes + +Les collections de cartes ont 17 champs par défaut. +Titre, +Joueur, +Équipe, +Marque, +Numéro de carte, +Année, +Séries, +Type de carte, +Date d'achat, +Prix d'achat, +Lieu, +Offert, +Mots clef, +Quantité, +Image recto, +Image verso, et +Commentaires. + + + + + +Collections de monnaie + +Les collections de monnaie ont 16 champs par défaut. +Titre, +Type, +Dénomination, +Année, +Mint Mark, +Pays, +Coin Set, +Grade, +Grading Service, +Purchase Date, +Purchase Price, +Location, +Offert, +Obverse, +Reverse, et +Commentaires. + + + + + +Collections de timbres + +Les collections de timbres ont 1_ champs par défaut. +Titre, +Description, +Dénomination, +Pays, +Année d'emission, +Couleur, +Scott#, +Grade, +Annulé, +Hinged, +Centrage, +Gommé, +Date d'achat, +Prix d'achat, +Lieu, +Offert, +Image, et +Commentaires. + + + + + +Collections de vins + +Les collections de vins ont 15 champs par défaut. +Titre, +Producteur, +Appellation, +Variété, +Type, +Pays, +Date d'achat, +Prix d'achat, +Lieu, +Quantité, +Bu par, +Note, +Offert, +Étiquette, et +Commentaires. + + + + + +Collections de jeux plateau + +Les collections de jeux de plateau ont 15 champs par défaut. +Titre, +Genre, +Mécanisme, +Année de parution, +Éditeur, +Créateur, +Nombre de joueurs, +Description, +Note personnelle, +Date d'achat, +Prix d'achat, +Offert, +Prêté, +Couverture, et +Commentaires. + + + + + +Catalogues de fichiers + +Les catalogues de fichiers ont 13 champs par défaut. +Nom, +URL, +Description, +Volume, +Type mime, +Taille, +Permissions, +Propriétaire, +Groupe, +Date de création, +Date de modification, +Autres informations, et +Icône, + + + + + +Collections personnalisées + +Les collections personnalisées ont un champ par défaut, le +Titre. Elle sont prévues pour pouvoir être utilisées +lorsque aucun type par défaut ne convient. + + + + + + + diff --git a/doc/fr/entry-editor1.png b/doc/fr/entry-editor1.png new file mode 100644 index 0000000..a7d6249 Binary files /dev/null and b/doc/fr/entry-editor1.png differ diff --git a/doc/fr/entry-editor3.png b/doc/fr/entry-editor3.png new file mode 100644 index 0000000..b2b4c3e Binary files /dev/null and b/doc/fr/entry-editor3.png differ diff --git a/doc/fr/entry-editor4.png b/doc/fr/entry-editor4.png new file mode 100644 index 0000000..f4ea2fa Binary files /dev/null and b/doc/fr/entry-editor4.png differ diff --git a/doc/fr/entry-editor5.png b/doc/fr/entry-editor5.png new file mode 100644 index 0000000..c3764b4 Binary files /dev/null and b/doc/fr/entry-editor5.png differ diff --git a/doc/fr/export-bibtex.png b/doc/fr/export-bibtex.png new file mode 100644 index 0000000..3304207 Binary files /dev/null and b/doc/fr/export-bibtex.png differ diff --git a/doc/fr/export-csv.png b/doc/fr/export-csv.png new file mode 100644 index 0000000..a25f272 Binary files /dev/null and b/doc/fr/export-csv.png differ diff --git a/doc/fr/export-html.png b/doc/fr/export-html.png new file mode 100644 index 0000000..06423f7 Binary files /dev/null and b/doc/fr/export-html.png differ diff --git a/doc/fr/export-options.png b/doc/fr/export-options.png new file mode 100644 index 0000000..af2bfe2 Binary files /dev/null and b/doc/fr/export-options.png differ diff --git a/doc/fr/export-pdb.png b/doc/fr/export-pdb.png new file mode 100644 index 0000000..0eb1d4a Binary files /dev/null and b/doc/fr/export-pdb.png differ diff --git a/doc/fr/externalexec-options.png b/doc/fr/externalexec-options.png new file mode 100644 index 0000000..f0773cb Binary files /dev/null and b/doc/fr/externalexec-options.png differ diff --git a/doc/fr/faqs.docbook b/doc/fr/faqs.docbook new file mode 100644 index 0000000..8929818 --- /dev/null +++ b/doc/fr/faqs.docbook @@ -0,0 +1,279 @@ + +Questions et réponses + + + + + + + +Comment démarrer le programme ? + + + +Après avoir télé-chargé et décompressé &appname;, exécutez +configure + + pour tout configurer: +Il se peut que vous ayez à modifier certaines options de la ligne +de commande. ensuite, exécuter +make compilera +&appname;. Ensuite, en tant qu'utilisateur root, exécutez +make install pour tout installer. +Être root n'est +nécessaire que si vous installez à un endroit où vous n'avez pas +les droits d'écriture. La commande pour démarrer &appname; est +tellico. Si vous installez +un binaire pré-empaqueté, une entrée dans le menu sera ajoutée pour +&appname;. + + + + + + +Comment saisir des auteurs multiples ? + + + +Les noms des auteurs doivent être séparés par un point-virgule, +de la façon suivante : +Brian W. Kernighan; Dennis M. Ritchie. N'ajoutez +pas le mot "et" ou un autre similaire, même s'il y a 20 auteurs. +Si l'option de mise en forme automatique est activée, le nom de famille +sera automatiquement affiché en premier pour chaque auteur. + +Les autres propriétés permettant des valeurs multiples, telles que +"genre" ou "mots-clef" sont saisis de la même manière, avec un point-virgule +entre chaque valeur. + + + + + + +Est-il possible de modifier l'apparence des pages imprimées ? + + + +Oui, bien sûr. Trouvez le fichier +tellico-printing.xsl qui devrait se trouver dans le +repertoire $KDEDIR/share/apps/tellico/. Vous pouvez le copier +dans $KDEHOME/share/apps/tellico/ pour y apporter des +modifications personnelles. Il est nécessaire de connaître le langage +&xslt;, mais modifier ce fichier +est la seule façon de changer la mise en forme. Les données &html; sont +produites à partir de ce fichier, et la manière la plus simple de changer +l'apparence à l'impression est de modifier le CSS dans la partie supérieure du +fichier. N'hésitez pas à poser des questions par e-mail. Les fichiers +d'impression alternatifs &xslt; seront disponibles sur +le site web &appname;. + +Prenez garde au fait que le fichier +tellico-printing.xsl fait référence à un autre, +tellico-common.xsl, qui contient certaines structures +&xslt; génériques. Si vous copiez tellico-printing.xsl +dans $KDEHOME, vous devrez soit modifier l'élément +<xsl:import> pour pointer vers la position du fichier +tellico-common.xsl ou copier le fichier commun avec. + + + + + +Comment regrouper selon un critère que ceux disponibles dans la barre d'outils ? + + + +Pour permettre de regrouper selon un champs qui le permet pas par défaut, +valider la case "Autoriser le regroupement" pour ce champs en particulier dans +la boite de dialogue "Champs de la collection". + + + + + +Qu'est-ce que tous ces messages qui s'affichent quand je lance &appname;? + +Des choses telles que : + +Tellico::updateCollectionToolBar +BCGroupView::setGroupAttribute - author +BCGroupView::slotAddCollection +QCheckBox::property( "title" ) failed: property invalid +or does not exist + + +sont des informations de déboggage. Lors de la compilation, ils peuvent être +désactivés avec l'option . +Vous pouvez également utiliser l'option +, qui utilise +un peu plus de mémoire lors de la compilation, mais rend l'application +plus efficace à l'exécution. + +Le dernier message est légèrement différent, il indique que votre +installation de Qt a été compilée avec des informations de déboggage. + +Ou, si &appname; est déjà installé, executez +kdebugdialog et assurez-vous +que "0 (generic)" n'est pas coché. Cette option désactive l'affichage de tous +les messages de déboggage venant d'applications KDE générique (i.e. celles qui +ne sont pas distribuées officiellement par KDE). + + + + + +Comment modifier les colonnes affichées ? + +Cliquez du bouton droit sur la barre d'en-tête. Vous pouvez également +déplacer les en-tête pour les ré-ordonner, ou cliquer dessus pour trier +selon un champ particulier. + + + + +Comment puis-je filtrer par rapport à un critère +comme le champs "Lu" ? + +En interne, le champ des cases à cocher de &appname; est sauvegardé avec +la valeur "true" ; donc si vous souhaitez filtrer pour n'afficher que les +livres de science fiction que vous n'avez pas lu par exemple, vous devez faire +deux règles de filtrage. Assurez-vous que la case "Vérifie toutes les règles" +est cochée. Configurez la première règle telle que "Genre" "contenant" +"Science Fiction" (sans guillemets) et la seconde pour avoir +"Lu" "ne contenant pas" "true" (sans guillemets). + +De plus, le filtre rapide de la barre d'outils fonctionne pour tous les +champs ; et s'il contient un caractère non alpha-numérique, le texte sera +interprété comme étant une expression régulière. Ainsi, si vous voulez rapidement +filtrer vos livres pour afficher ceux de Weber ou Bujold, tapez "weber|bujold" +(sans guillemets) dans la barre d'outils. + + + + +Comment ajouter de nouveaux modèles d'entrées ? + + +Les modèles d'entrées devraient être savés dans +$KDEHOME/share/apps/tellico/entry-templates/ +pour un utilisateur simple, ou dans +$KDEDIR/share/apps/tellico/entry-templates/ +pour qu'ils soient accessibles à tous. Les modèles dans $KDEHOME +sont prioritaires sur les fichiers portant le même nom dans $KDEDIRS. +Les modèles d'entrées peuvent être configurés par type de collection dans la +boite de dialogue de configuration. + +Les modèles pour la &report-dialog; sont enregistrés dans +$KDEHOME/share/apps/tellico/report-templates/. + + + + + +La compilation et l'installation se sont bien déroulées, +mais quand &appname; démarre, la fenêtre est vide. Qu'est-ce qui +ne va pas ? + + +Les logiciels KDE cherchent les données à l'endroit défini par la variable + d'environnement $KDEDIRS. Si vous installez dans + /usr/local par exemple, mais que + $KDEDIRS est vide ou seulement /usr, + alors &appname; ne pourra pas trouver les fichiers dont il a besoin. Ceci est + particulièrement vrai pour SuSE, pour lequel vous devriez compiler avec + =/opt/kde3. Alternativement, + vous pouvez ajouter une ligne à votre fichier .profile pour + configurer $KDEDIRS. Veuillez consulter la documentation + de votre shell pour plus de détails. + + + + +Comment exporter des champs BibTeX supplémentaires ? + +&appname; utilise la propriété bibtex pour savoir +comment exporter les champs BibTeX. Si vous souhaitez ajouter de nouveaux +champs à exporter, tels qu'un résumé (abstract), ouvrez la &fields-dialog;, et +cliquez sur le bouton Propriétés étendues. Ajoutez une +propriété bibtex avec la valeur +abstract. Par la suite, lorsque vous exporterez vos +données vers un format BibTeX ou BibTeXML, cette propriété sera utilisée pour +le nom du champs BibTeX. + + + + + +Qu'est-il arrivé à Bookcase ? + + + +En raison d'un conflit de marques, Bookcase a été renommé Tellico en septembre 2004. +Tellico 0.12 est alors paru, qui était identique à +Bookcase 0.11, à l'exception du changement de nom. + + + + + +Le nom Tellico est-il une référence à quoi que ce soit ? + + + +L'auteur a pensé à +plusieurs autres noms, dont certains étaient liés à des colletions de +livres. Cependant, Tellico permet de gérer plus que des livres: En outre; le +développement de tellico est un passe-temps ; l'auteur a donc choisi un nom qui +lui plaisait, celui d'une ville proche de l'endroit où il a grandi. + + + + + +Pourquoi incluez-vous ces liens vers Amazon.com dans les résultats des recherches ? + + + + +Les termes de l'accord pour accéder aux Services Web Amazon.com +requièrent que toutes les images chargées par ce service disposent d'un lien +vers Amazon.com, ainsi que d'un lien additionnel. +Le numéro d'identification d'associé à Amazon.com est obligatoirement inclus, +afin que des paiements ultérieurs puissent être dûment collectés. + + + + + + +Pourquoi ne pas utiliser une vraie base de données? + + + + +L'une des raisons pour lesquelles l'auteur a écrit &appname; était d'apprendre +le C++. Il ne connaissait pas le SQL à l'époque, et pour le moment il a une +vague idée sur la façon de s'en servir. Dit simplement, &appname; n'a pas été +conçu au départ comme une base de données relationnelle, et cela ne changera pas +avant qu'il ait appris le SQL et eu le temps et la motivation de changer le +modèle de données. Si ça vous pose un problème, n'utilisez pas &appname;. + + + +Bien entendu, toute modification apportée au code est la bienvenue. + + + + + + diff --git a/doc/fr/fetch-dialog.png b/doc/fr/fetch-dialog.png new file mode 100644 index 0000000..640d6c6 Binary files /dev/null and b/doc/fr/fetch-dialog.png differ diff --git a/doc/fr/fields-dialog.png b/doc/fr/fields-dialog.png new file mode 100644 index 0000000..ba6adb1 Binary files /dev/null and b/doc/fr/fields-dialog.png differ diff --git a/doc/fr/filter-dialog.png b/doc/fr/filter-dialog.png new file mode 100644 index 0000000..430355b Binary files /dev/null and b/doc/fr/filter-dialog.png differ diff --git a/doc/fr/filter-view.png b/doc/fr/filter-view.png new file mode 100644 index 0000000..11420df Binary files /dev/null and b/doc/fr/filter-view.png differ diff --git a/doc/fr/freebsd-doc-license.html b/doc/fr/freebsd-doc-license.html new file mode 100644 index 0000000..ae93752 --- /dev/null +++ b/doc/fr/freebsd-doc-license.html @@ -0,0 +1,57 @@ + + + + FreeBSD Documentation License + + + + + + + + + +

FreeBSD Documentation License

+ +

Redistribution and use in source (SGML DocBook) and 'compiled' + forms (SGML, HTML, PDF, PostScript, RTF and so forth) with or + without modification, are permitted provided that the following + conditions are met:

+ +
    +
  1. +

    Redistributions of source code (SGML DocBook) + must retain the above copyright notice, this list + of conditions and the following disclaimer as the + first lines of this file unmodified.

    +
    2. + +
  2. +

    Redistributions in compiled form (transformed to + other DTDs, converted to PDF, PostScript, RTF and + other formats) must reproduce the above copyright + notice, this list of conditions and the following + disclaimer in the documentation and/or other + materials provided with the distribution.

    + +
    3. +
+ +

THIS DOCUMENTATION IS PROVIDED BY THE FREEBSD + DOCUMENTATION PROJECT "AS IS" AND ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL + THE FREEBSD DOCUMENTATION PROJECT BE LIABLE FOR ANY + DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF + USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER + IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE + USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE.

+ + diff --git a/doc/fr/fundamentals.docbook b/doc/fr/fundamentals.docbook new file mode 100644 index 0000000..7750615 --- /dev/null +++ b/doc/fr/fundamentals.docbook @@ -0,0 +1,841 @@ + +Utiliser &appname; + + +Démarrage rapide + + +Par défaut, &appname; démarre avec une collection de livres vide. Pour +travailler avec un autre type de collection, créez-la en utilisant le menu +FichierNouveau, +ou le bouton dans la barre d'outils. Les collections sont remplies avec +certains des champs les plus communs ; mais vous pouvez en ajouter, enlever ou +les modifier selon vos besoins. + + + +Les nouvelles entrées peuvent être ajoutées en utilisant +l'&entry-editor;. Le menu +CollectionNouvelle entrée +ouvre l'&entry-editor; avec une entrée vide pour la compléter. +L'&entry-editor; peut également être ouvert en utilisant le menu +ParamètresAfficher l'&entry-editor;. +Une fois que vous avez entré les valeurs pour une entrée, vous pouvez les +inclure à la collection en cliquant sur +Enregistrer l'entrée dans la boite de dialogue de +l'&entry-editor;, qui reste ouverte dans le cas où vous souhaiteriez ajouter de +nouvelles entrées. +Une fois que vous avez enregistré une entrée dans la collection, vous pouvez la +modifier en cliquant dessus dans la fenêtre principale. +Si l'&entry-editor; n'est pas déjà ouvert, vous pouvez double-cliquer sur une +entrée pour ouvrir l'éditeur et la modifier. + + + +Si vous souhaitez inclure une image avec une entrée, vous pouvez utiliser le +sélecteur de fichiers standard &kde; en cliquant sur le bouton +Sélectionner une image... dans +l'&entry-editor;, ou vous pouvez déplacer +une image depuis le gestionnaire de fichiers ou le navigateur internet dans +l'&entry-editor;. + + + +Quand vous sélectionnez une entrée, la +&entry-view; affiche une vue mise en forme du +contenu de l'entrée. +Vous pouvez modifier le modèle utilisé pour afficher l'entrée dans la +&config-dialog;. + + + +Les entrées d'une collection sont groupées ensemble lorsqu'elles ont la même +valeur dans certains champs, tels que l'auteur ou le réalisateur. +Vous pouvez modifier le champ utilisé pour grouper en utilisant le menu +déroulant dans la barre d'outils ou dans le menu +ConfigurationOptions de regroupement. + + + +Vous pouvez utiliser le &quick-filter; dans la barre d'outils pour limiter +rapidement le nombre d'entrées visibles à celles contenant le mot que vous y +entrez. Ce filtre est également utile quand vous souhaitez trouver rapidement +une entrée. Vous pouvez y entrer le titre ou une autre mot unique qui identifie +l'entrée et la &detailed-view; affichera +uniquement les entrées correspondant au filtre. La barre d'état indique +combien d'entrées existent dans la collection, et combien sont actuellement +filtrées. + + + + + +Utilisation générale + + +La fenêtre principale a trois parties distinctes ; chacune affichant des +informations sur la collection de manière différente. La partie principale est +la &detailed-view; dans la partie +supérieure droite ; où les valeurs tous les champs de chaque entrée peuvent +être affichées. +Dans la partie gauche, la &group-view; peut +être utilisée pour afficher les entrées sous forme de groupes dans une +arborescence. +La &filter-view; permet de ne voir que les +entrées répondant à certains critères. +La &loan-view; affiche les entrées prêtées. +Enfin, la &entry-view; affiche les données +d'une entrée mises en forme, ou une vue par icônes d'un groupe d'entrées, dans +la partie inférieure droite. + + + +La fenêtre principale de &appname; + + +La fenêtre principale de &appname; + + + + +&detailed-view; + + +Tous les champs d'une collection peuvent être affichés dans la &detailed-view; ; +bien que les champs de type +Paragraphe, +Image et +Table ne soient probablement +pas utiles. Cliquer du bouton droit sur l'en-tête affiche un menu permettant de +choisir les champs visibles. Les colonnes peuvent être dimensionnées et +réordonnées ; et les paramètres sont conservés d'une session à l'autre. + + + + +&group-view; + + +La &group-view; rassemble les les entrées dans une arborescence selon un champ +permettant le regroupement. +Le nombre d'entrées dans chaque groupe peut être affiché à coté de son nom en +changeant une option dans la +&config-dialog;. +Les groupes peuvent être développés en cliquant sur le signe plus, ou en +double-cliquant sur le groupe. +Développer ou refermer tous les groupes sont des options dans le menu +contextuel du clic droit. +L'arbre peut être trié, soit par nom de groupe, soit par nombre d'entrées, en +cliquant du bouton droit sur un groupe. +Un groupe peut également être utilisé en tant que filtre pour la +&detailed-view; en cliquant du bouton droit +sur le groupe. + + + +Quand plus d'un champ de la collection a l'option +Mise en forme comme un nom +activée, un groupe supplémentaire est ajouté, regroupant tous ces champs dans +un seul pseudo-groupe Personnes. + + + +Si une entrés ne contient pas de valeur pour le champ utilisé pour former les +groupes, celle-ci est placées dans le groupe (Vide), qui +utilise un répertoire rouge. + + + + +&filter-view; + + +Si des filtres ont été enregistrés pour la collection, la &filter-view; devient +active. Au fur et à mesure que vous ajoutez et modifiez des entrées, celles-ci +seront automatiquement vérifiées par les filtres et ajoutées ou enlevées en +fonction des résultats. Le filtre peut être modifié en double-cliquant dessus +pour ouvrir la &filter-dialog;. Un clic du bouton droit dessus vous permet +également de le supprimer complètement. + + + +La &filter-view; + + +La &filter-view; + + + + + + +&loan-view; + + +Une fois que des entrées ont été marquées comme prêtées, la &loan-view; est +ajoutée à la fenêtre, pour que les entrées empruntées puissent être suivies. +Ceci est fait individuellement pour chaque entrée. Cliquer du bouton droit sur +une entrée propose une option pour modifier le prêt avec la &loan-dialog;. + + + +La &loan-view; + + +La &loan-view; + + + + + + +&entry-view; + + +Une représentation mise en forme des valeurs de l'entrée sélectionnée est +affichée dans la &entry-view;. +Des modèles sont utilisés pour le format d'affichage et les images +supplémentaires. +Des modèles différents pour chaque type de collection peuvent être spécifiés +dans la &config-dialog;. +Les modèles par défaut affichent les champs de type &URL; actifs, qui s'ouvrent +avec l'association de fichier par défaut de &kde; +Lors des exports en &html;, le modèle courant est utilisé pour exporter les +fichiers d'entrées individuels. + + + +De plus, lorsque plusieurs entrées sont sélectionnées, une vue par icônes +des entrées est affichée, en utilisant le +premier champ de type Image de la collection. +Les entrées peuvent être sélectionnées dans la &detailed-view;. Un clic +droit sur la vue par icônes affiche un menu qui permet de changer les critères +de tri des entrées. + + + + + +Barre d'état + + +La barre d'état est utilisée pour indiquer ce que &appname; est en train de +faire. Elle contient également le nombre total d'entrées dans la collection ; +et si un filtre est utilisé, combien sont visibles. + + + + + + +Modifier des entrées + + +L'&entry-editor; est utilisé pour ajouter et modifier des entrées dans la +collection. +Double-cliquer sur une entrée dans la &group-view; ou la &detailed-view; +ouvre l'&entry-editor; avec cette entrée. +De nouvelles entrées peuvent être créées par le menu +Collection, +l'icône de la barre d'outils, ou le bouton dans l'&entry-editor;. + + + +Fermer l'&entry-editor; alors que des changements n'ont pas été enregistrés +provoque l'affichage d'un message. +Les champs sont regroupés par catégorie et apparaissent suivant l'ordre dans +lequel ils sont classés dans la +&fields-dialog;. +Ils peuvent donc également être réordonnées. + + + +L'&entry-editor; + + +L'&entry-editor; + + + + +Cliquer sur le champ du titre d'une +&URL; ouvre le lien en fonction +du type de fichier défini dans &kde;. Le bouton +sélecteur d'&URL; à côté de l'entrée de texte ouvre la +boite de dialogue de fichier &kde; par défaut ; mais le champ n'est pas limité +aux fichiers locaux. Tout type d'&URL; peut être entré. Les &URL; relatives ne +sont pas gérées pour le moment, la valeur étant interprétée par rapport à +l'endroit où se trouve la feuille de style du modèle. + + + +Pour les champs de type Image, +le bouton Sélectionner l'image... ouvre la boite de +dialogue de sélection d'image &kde;. L'image est enregistrée dans la +collection dans son format d'origine, et une version mise à l'échelle est +affichée dans l'&entry-editor;. L'image peut être effacée avec le bouton +Effacer. Les images effacées sont retirées de la +collection. + + + +L'&entry-editor; pour les champs de type Image + + +L'&entry-editor; pour les champs de type Image + + + + +L'éditeur gère également le glisser-déposer. Déplacer une image depuis une +fenêtre &konqueror; aura le même effet que de la choisir à l'aide du +sélecteur de fichiers. Glisser une image depuis l'éditeur vers une fenêtre +&konqueror; enregistrera l'image dans le répertoire. + + + + +Par défaut, les images sont enregistrées dans le fichier de données de la +collection, conservant ainsi toutes les données au même endroit. Cependant, +un trop grand nombre d'images ralentira &appname; et générera des fichiers de +taille importante. Cependant, &appname; peut également enregistrer les images +séparément, soit dans le répertoire +$KDEHOME/share/apps/tellico/data/, +soit dans un répertoire au même endroit que le fichier de données Tellico. +Dans ce cas, le chargement et l'enregistrement des fichiers de données est +nettement plus rapide ; mais les fichiers de données ne peuvent alors plus être +transférés ou sauvegardés sans perdre les images. Des fichiers autonomes +(contenant les images) peuvent toujours être créés en utilisant le menu +FichierExporterExporter au format Zip.... + + + + +Les champs de type Tableau sont +initialement créés avec 5 lignes ; mais déplacer le curseur jusqu'à la +dernière ligne en ajoutera une autre. Dans les tableaux à é colonnes, seule +la première est utilisée pour le regroupement ou la mise en forme. + + + +L'&entry-editor; pour les champs de type Tableau + + +L'&entry-editor; pour les champs de type Tableau + + + + +Editer plusieurs Entrées + +Plusieurs entrées peuvent être modifiées en même temps, en les sélectionnant +dans la &group-view; ou la &detailed-view;. Si plusieurs entrées sont +sélectionnées, les champs contenant la même valeur sont actifs. Dans les cas +contraire, ils sont désactivés. Une case à cocher est ajoutée à droite de +chaque champ, permettant de contrôler si le champ est actif ou non. + + + +Seuls les champs actifs seront modifiés à la sauvegarde des entrées, ce qui +rend la modification de nombreuses entrées plus simple. Par exemple, pour +changer le type de medium dans une collection de vidéos, éditez les entrées +simultanément, cochez la case pour activer le champ Medium, entrez la valeur +DVD, et enregistrez les entrées. Seul le champ Medium a été +modifié, préservant les valeurs originales de tous les autres champs. + + + +L'&entry-editor; pour plusieurs entrées + + +L'&entry-editor; pour plusieurs entrées + + + + + + +Mettre à jour les données d'une entrée + + +Les entrées peuvent être automatiquement mises à jour par des requêtes aux +sources de données disponibles pour le type de collection en cours. Ceci peut +être très utile pour combiner les informations de plusieurs sources. Par +exemple, vous pouvez vouloir ajouter un film à votre collection avec les +services web Amazon.com, puis mettre +à jour l'entrée avec des informations supplémentaires en provenance de +IMDb. + + + +Seuls les champs vides sont mis à jour ! Si vous voulez mettre à jour la liste +des acteurs d'un film, effacez les données avant de mettre à jour. Pour les +scripts externes, un champ mis à jour peut +être spécifié dans les options de la source. + + + +La mise à jour d'entrée peut être démarrée via un clic droit pour une entrée, ou +en utilisant le menu +CollectionMettre à jour l"entrée. + + + + + + +Editer les champs + + +La &fields-dialog; vous permet d'ajouter de nouveaux champs à la collection, +de modifier ceux existant ou en effacer. + + + +La &fields-dialog; de &appname; + + +La &fields-dialog; de &appname; + + + + +Liste des champs + + +Sur le côté gauche de la boîte de dialogue se trouve la liste des champs. Ceux +qui ont été modifiés apparaissent en gras et italique. Les boutons sous la liste +permettent d'ajouter ou de supprimer des champs, et les flèches de changer leur +ordre. L'ordre des champs dans la liste est important, puisqu'il est utilisé par +l'&entry-editor; pour leur affichage. Pour chaque catégorie, les +champs sont disposés de gauche à droite, en fonction de l'ordre (de haut en bas) +dans lequel ils apparaissent dans la liste. + + + + +Propriétés des champs + + +Un champ est défini par ses titre, type, catégorie, description et +éventuellement d'autres valeurs autorisées. Le titre est utilisé partout pour +référer au champ dans l'interface utilisateur. L'&entry-editor; l'utilise pour +l'affichage de valeurs. La &detailed-view; l'utilise en tant qu'en-tête de +colonnes. Les différents types de champs sont détaillés dans la section +Types de champs. La description est utilisée +en dans une bulle d'information dans l'&entry-editor;, pour fournir des +explications complémentaires sur le contenu du champ. De plus pour les champs +de type Dépendant, la +description est utilisée pour mettre en forme la valeur du champ. Les valeurs +possibles pour un champ de type +Choix doivent être séparées +par des point-virgule. + + + +Les nouveaux champs peuvent être de n'importe quel type ; mais la modification +du type de champs existant est limitée à ceux compatibles, tels qu'indiqués dans +le tableau suivant : + + + +Changements de type de champ autorisés + + + +Type d'origine +Nouveaux types possibles + + + + +Texte simple +Texte simple, Paragraphe, Nombre, URL, Tableau + + +Paragraphe +Texte simple, Paragraphe + + +Choix +Texte simple, Paragraphe, Choix, Nombre, URL, Tableau + + +Case à cocher +Texte simple, Paragraphe, Case à cocher, Nombre, URL, Tableau + + +Nombre +Texte simple, Paragraphe, Nombre, URL, Tableau + + +URL +Texte simple, Paragraphe, Nombre, URL, Tableau + + +Date +Texte simple, Date + + +Tableau +Texte simple, Paragraphe, Tableau + + +Image +Image + + +Note +Choix, Note + + +Dependant +Dependant + + + +
+ + + +Mise en forme des champs + + +&appname; propose la possibilité de mettre en forme automatiquement la valeur +de certains champs. La plis simple mise en forme est la mise en majuscules +automatique, qui met en majuscule la première lettre de chaque mot, à +l'exception des articles. La mise en forme des titres déplace certains articles +du début à la fin du champ. Par exemple "Le Retour du Roi" devient "Retour du +Roi, Le". Les articles apparaissant dans les titres sont configurables. Enfin, +la mise en forme des noms essaie de décomposer le texte, de manière à afficher +le nom de famille en premier. Les différentes particules ou attributs sont +configurables. De plus, le groupe spécial +Personnes utilise tous +les champs mis en forme en tant que noms, même si le paramètre global est +désactivé. + + + +Toute mise en forme automatique peut être désactivée en modifiant les options +générales dans la &config-dialog;. +Généralement, la mise en majuscules est une opération distincte de la mise en +forme ; donc un titre peut être automatiquement mis en fome sans activer la mise +en majuscules. +Tous les champs ne permettent pas la mise en forme automatique. + + + +Exemples de mise en forme + + + +Type de mise en forme +Valeur du champ +Majuscules automatiques +Mise en forme automatique +Majuscules et mise en fome automatiques + + + + +Titre +le retour du roi +Le Retour du Roi +retour du roi, le +Retour du Roi, Le + + +Nom +tom swift, jr. +Tom Swift, Jr. +swift, jr., tom +Swift, Jr., Tom + + + +
+ + +Options de champ + + +Les champs ont également trois options générales. Si l'auto-complétion est +activée, &appname; conserve en mémoire les valeurs de chaque champ et +l'&entry-editor; propose de compléter automatiquement les mots, suivant les +paramètres standard de &kde;. +Tous les champs ne permettent pas l'auto-complétion. +&appname; doit également savoir si un champ peut avoir des valeurs multiples +ou s'il peut être utilisé pour regrouper les entrées. +Un point-virgule est utilisé pour différencier les valeurs multiples lors de +l'édition d'une entrée. + + + +Pour des raisons d'efficacité, n'activez pas l'auto-complétion, sauf si vous en +avez besoin pour les champs. Plus il y a de champs avec l'auto-complétion +activée dans une collection, plus &appname; est lent à charger le fichier. + + + + + + +Filtrer les entrées + +La &filter-dialog; permet de limiter les entrées visibles dans la +&detailed-view; à celles respectant une ou +plusieurs règles de filtrage. +Le filtre peut être utilisé pour trouver les entrées respectant toutes les +règles de la boite de dialogue, ou celles en respectant au moins une. + + + +La &filter-dialog; de &appname; + + +La &filter-dialog; de &appname; + + + + +Chaque ligne contient une seule règle de filtrage. +Sélectionner un champ à vérifier dans la première boite de la ligne, puis une +règle de filtrage dans celle du centre. +Les règles permettent de chercher des valeurs contenant un certain mot ou sont +exactement identiques. +Une expression régulière peut également être utilisée pour filtrer les entrées, +auquel cas le bouton Éditer... devient actif pour +modifier l'expression. +Enfin, le mot ou la chaîne de caractères doit être entré dans la boite de texte. + + + +Jusqu'à huit (8) règles peuvent être utilisées dans le filtre. Les boutons +Plus et Moins peuvent être +utilisés pour ajouter ou enlever des règles. + + + + +Pour trouver les livres de science fiction que vous n'avez pas lu, validez +le bouton Vérifier toutes les règles, configurez la +première règle sur Genre contenant science fiction, et la +seconde sur Read ne contient pas true. +Read ne contenant pas true. +(Pour les champs de type Case à cocher, la valeur +interne est true). + + + +Pour trouver les livres écrits par Bujold et Weber, validez le bouton +Vérifie une des règles, configurez la première règle sur +Auteur contenant Bujold, et la seconde sur +Auteur contenant Weber. + + + + + + +Generating Reports + +&appname; peut générer divers rapports concernant votre collection. La +&report-dialog; vérifie les modèles &xslt; dans le répertoire d'installation +ainsi que dans +$KDEHOME/share/apps/tellico/report-templates/. +Vous pouvez ainsi en créer de nouveaux, qui seront automatiquement inclus sous +forme d'options dans la &report-dialog;. Certains rapports complexes peuvent +nécessiter un certain temps pour leur génération. + + + +Les modèles installés avec &appname; incluent seulement une liste des titres, +la vue en colonne, une vue de groupe, une résumé des groupes et des valeurs les +plus présentes dans ces groupes, un rapport de prêts, et un rapport plus complet +contenant les images. Sélectionnez le modèle désiré et cliquez sur le bouton +Générer. Tout rapport peut également être imprimé ou +enregistré dans un fichier &html;. + + + +La &report-dialog; &appname; + + +La &report-dialog; &appname; + + + + +Les entrées incluses dans le rapport seront limitées à celles de la +&detailed-view; ; donc si vous avez un filtre activé, la &report-dialog; +l'utilisera. + + + + +Gestion des prêts + +&appname; gère les prêts d'entrées de la collection. La &loan-dialog; peut être +ouverte en utilisant le menu Prêter, ou en cliquant du +bouton droit sur une entrée. Plusieurs entrées peuvent être prêtées en une seule +opération. + + + +Le nom des personnes empruntant peut être entré directement, ou être extrait +du carnet d'adresses par défaut de &kde; en cliquant sur le bouton à côté du +champ "Nom". La date du prêt est par défaut celle du jour courant ; mais peut +être modifiée. La date de retour dû est optionnelle, et d'autres notes peuvent +être ajoutées à propos du prêt. + + + +Si une date de retour dû est entrée, et si &appname; a été compilé avec la +gestion de la libkcal, une alarme peut être ajoutée au calendrier par défaut +de &kde; en tant qu'item "à faire". &korganizer; peut être utilisé pour voir +ces entrées. + + + +Lorsqu'une entrée est prêtée, la valeur du champ Prêté +est mise à la valeur true. Si aucun autre champ "Prêté" +n'existe dans la collection, celui-ci est ajouté. Ne modifiez pas ce champ +manuellement ! Les entrées prêtées peuvent être marquées comme rendus en +utilisant le menu ou en cliquant du bouton droit sur une entrée dans la +&loan-view;. + + + +La &loan-dialog; &appname; + + +La &loan-dialog; &appname; + + + + + + +Astuces générales + + +Ceci est la liste des astuces contenues dans les "astuces du jour de &appname;. + + + + +Si un livre a plus d'un auteur, les noms doivent être séparés par des +point-virgule, afin que &appname; puisse les dissocier et les utiliser +séparément. Tous les autres champs permettant d'avoir plusieurs valeurs doivent +être saisis de la même manière. + + + + + +Vous pouvez choisir quels champs doivent être affichés dans la vue en liste en +cliquant du bouton droit sur l'en-tête des colonnes. + + + + + +Vous pouvez ajouter ou modifier les champs de la collection avec la +&fields-dialog;. Les boutons avec des flèches sous la liste peuvent être +utilisés pour changer la position dans la liste, ce qui affecte le +positionnement dans l'&entry-editor;. + + + + + +Si vous souhaitez filtrer selon un champ +Case à cocher, la valeur +"true" doit être utilisée. Si vous voulez afficher uniquement les films de +science fiction que vous n'avez pas lus, par exemple, cochez la case +Vérifie tout, configurez la première règle en tant que +"Genre" "contient" "Science Fiction" (sans guillemets) et la seconde règle en +tant que "Lu" "ne contient pas" "true" (sans guillemets). + + + + + +Si un caractère non alphabétique est utilisé dans le filtre rapide, le texte +est interprété en tant qu'expression régulière. Pour afficher uniquement les +livres de Weber ou Bujold par exemple, entrez "weber|bujold" (sans guillemets) +dans la boîte de filtre. + + + + + +Vous pouvez modifier plus d'une entrée à la fois, en gardant appuyée la touche +Maj ou Control et en sélectionnant plusieurs entrées. + + + + + +Vous pouvez convertir une collection de livres en bibliographie, qui peut alors +être exportée au format BibTeX ou BibTeXML. + + + + + + +Si plus d'un champ est mis en forme en tant que nom, un group supplémentaire +appelé "Personnes" est ajouté à la collection, permettant ainsi aux auteurs et +éditeurs d'être affichés ensemble, par exemple. + + + + + +Vous pouvez modifier l'apparence des données affichées en modifiant le fichier +tellico-printing.xsl. Le fichier génère du &html; ; et le +&css; contenu dans la feuille de style détermine les aspects tels que les +polices, marges, etc. + + + + + +Double-cliquer sur une entrée ouvre l'&entry-editor;. + + + + + +Vous pouvez ajouter des tags &html; aux champs de type +paragraphe pour la mise en +forme, tels que <b>bold</b> (gras) +ou <i>italic</i> (italique). + + + + + +Dans la &detailed-view;, vous pouvez presser une lettre au clavier pour +aller directement you can press a letter on the +keyboard to skip to the next entry that starts with that letter. + + + + + +Vous pouvez utiliser les champs dépendant pour combiner plusieurs champs dans +un seul. Sélectionez le type dépendant pour le champ et entrez une description +similaire à "Value: %{fielda}%{fieldb}" en remplaçant le +contenu de %{...} par le nom de champ approprié. Ceci est utile pour regrouper +plusieurs valeurs dans un seul champ ; par exemple pour un meilleur +regroupement ou combiner différents champs tout en respectant les critères de +tri. Considérez par éxemple un champ numérique suivi par un champ de text avec +des entrées 3b et 14a. + + + + + + diff --git a/doc/fr/general-options.png b/doc/fr/general-options.png new file mode 100644 index 0000000..6ba694d Binary files /dev/null and b/doc/fr/general-options.png differ diff --git a/doc/fr/hacking.docbook b/doc/fr/hacking.docbook new file mode 100644 index 0000000..ed30c0a --- /dev/null +++ b/doc/fr/hacking.docbook @@ -0,0 +1,448 @@ + +Hacking &appname; + + +Suivant l'esprit du Logiciel Libre, vous pouvez modifier &appname; autant que +vous le désirez. Il devrait être très simple d'écrire des scripts pour importer, +exporter ou modifier des données. +Ce chapitre vous donne plus d'informations sur ce sujet. + + + +Format de fichiers + + +Le format de fichier par défaut de &appname; est une archive zip, normallement +avec une extension de fichier en .tc. +A l'intérieur de l'archive se trouve un fichier +tellico.xml. +Les images peuvent être placées dans le répertoire images/ +dans l'archive, ou être incluses directement dans le flux &xml; encodées au +format base64. Les images peuvent également être enregistrées dqns le repertoire +de données de l'application ; auquel cas elles ne sont pas du tout présentes +dans le fichier de données. +&appname; peut également charger le fichier &xml; directement; non compressé. + + + +Données &xml; + + + + + +Collection + + + + + + + +]]> + + + +Le fichier commence par la déclaration et l'encodage &xml; requis, suivis par +le type de document ("doctype"). Quand un nouveau champs est ajouté ou une +propriété aditionelle attribuée aux champs par défaut, la version de DTD du +doctype est incrémentée. +&appname; est toujours capable d'ouvrir et lire les versions de DTD +précédentes, mais sauvegarde les fichiers dans la version courante. +La localisation DTD pointe vers le ficher DTD lui-même. + + + +L'élément racine est un élément <tellico>, contenant la +déclaration de l'espace de nommage par défaut et la version de la syntaxe du +fichier, qui devraient toujours etre identiques à ceux de la DTD. + + + +L'élément <tellico> contient un élément +<collection>. +Les collections multiples sont ignorées pour le moment. L'attribut +title contient le nom de la collection, alors que l'attribut +type specifie quel type d'entrées est contenu dans la +collection. La liste des types disponibles est disponible dans +une autre section. Un attribut +optionnel entryTitle peut être utilisé pour spécifier le nom +des entrées dans une collection personnalisée, et devrait être au pluriel. + + + + +Champs + + + + + + + + + + + + + + + + +]]> + + + +Tous les champs sont définis dans un élément <fields>, +qui doit être unique. Toutes les informations d'un champ, à l'exception des +propriétés étendues, sont incluses dans l'élément +<field>. Les valeurs possibles pour les attributs +flags, format, et type sont +données dans une section suivante. + + + +Un élément <field> avec un attribut "name" égal à +_default indique à &appname; d'inclure tous les champs +par défaut de ce type de collection. + + + + +Entrées + + + + Le langage C++, édition revue et corrigée + + Stroustrup, Bjarne + + Pearson Education + 3rd + 2003 + 2-7440-7003-3 + + Non-Fiction + + + Programmation et langages + Informatique et Internet + + cf65a2f023b6cb9e9233323dca10ac7c.jpeg + +]]> + + + +Pour chaque champs de la collection, un élément <entry> +peut contenir un élément dont le nom est identique à celui du champs. +Si des valeurs multiples sont possibles pour ce champ, la lettre +s est ajoutée au nom du champ pour créer un élément. +Chaque valeur est ajoutée en tant que descendant de cet élément, comme c'est le +cas pour les champs author, genre et keyword ci-dessus. + + + +En conséquence, si de nouveaux champs sont ajoutés à la collection, le fichier +de données ne sera plus conforme à la DTD. Cependant, &appname; utilise un +analyseur &xml; ne vérifiant pas la validité des champs, ceux-ci ne posent donc +pas problème. + + + + +Images + + + + +]]> + + + +A l'intérieur de chaque élément <images> apparait chaque +image référencée par une entrée, ainsi que les attributs décrivant la taille +de l'image, son format et son numéro d'identification. Si l'image est contenue +dans le fichier Zip, l'élément est vide. Dans le cas contraire les données de +l'image peuvent être contenues dans le flux &xml; sous forme de text encodé au +format base64. + + + + + + + + +Valeurs des types de collections + + +Le type de collection est donné dans l'attribut "type" de l'élément +"collection". La valeur est égale à celle de l'enum Type défini +dans src/collection.h. + + + +Valeurs des types de collections + + + +Type de collection +Valeur + + + +Custom Collection1 +Book Collection2 +Video Collection3 +Music Collection4 +Bibliography5 +Comic Book Collection6 +Wine Collection7 +Coin Collection8 +Stamp Collection9 +Trading Card Collection10 +Video Game Collection11 +File Catalog12 + + +
+ + + + + +Valeurs des types de champs + + +&appname; inclut tous les champs par défaut de la collection si le premier +élément est nommé _default. Pour les champs +Paragraphe, Tableau ou +Image, la catégorie du champ doit être identique au titre +du champ. + + + +Le type de champ est donné dans l'attribut type de l'élément. +La valeur est égale à celle de l'enum FieldType défini dans +src/field.h. Le type Lecture seule +était prévu pour pour les champs devant être conservés ; mais ne pouvant +pas être modifiés par l'utilisateur, tels que les champs ajoutés lors de +l'import d'une collection dans une autre format. Il n'est pas utilisé. + + + +Valeurs des types de champs + + + +Type de champ +Valeur + + + +Texte simple1 +Paragraphe2 +Choix3 +Case à cocher4 +Lecture seule5 +Nombre6 +URL7 +Tableau à une colonne8 +Tableau à deux colonnes9 +Image10 +Dépendant11 +Date12 + + +
+ + +Le champ peut avoir plusieurs options, données par la valeur d'un champ de bits +dans l'attribut flags de l'élément du champ. L'option interdisant à +l'utilisateur d'effacer un champ est prévue pour des données telles qu'une +citation dans une entrée bibliographique. + + + +Valeurs des options de champ + + + +Option de champ +Valeur + + + +Autoriser des valeurs multiples0x01 +Autoriser le regroupement0x02 +Activer l'auto-complétion0x04 +Interdire l'effacement0x08 + + +
+ + +La mise en forme du champ est donnée dans l'attribut format de l'élément. +Date n'est pas utilisé pour le moment. Le regroupement par +Personne utilise tous les champs ayant une mise en forme +de Nom. + + + +Valeurs de mises en forme de champ + + + +Format de champ +Valeur + + + +Capitales0 +Title1 +Nom2 +Date3 +Pas de mise en forme4 + + +
+ + + + +Options de configuration cachées + + +&appname; dispose de certaines options de configuration qui ne sont pas visibles +dans la &config-dialog;. Elles ne sont pas suffisament importantes pour charger +la boite de dialogue avec plus d'options, mais puisqu'elles peuvent être utiles +à certains utilisateurs, l'application les lit dans le fichier de configuration. + + + +Les paramètres de &appname; sont enregistrés dans un fichier du répertoire de +l'utilisateur, +$KDEHOME/share/config/tellicorc. +Dans ce fichier; les paramètres sont rassemblés dans des groupes qui +apparaissent avec un nom entre crochet, tel que [General Options]. +Pour ajouter un paramètre au groupe General Options, +trouvez la ligne dans le fichier de configuration avec ce nom de groupe. +S'il n'apparait pas, créez-le vous-même en ajoutant une ligne [General Options]. +Les paramètres peuvent alors être ajoutés sur les lignes suivantes. + + + +[General Options] + + +Ces paramètres doivent être placés dans le groupe +General Options. + + + +Max Icon Size + + +La taille maximum des icones dans la &icon-view; peut être changée avec cette +option. La valeur par défaut est 96, et peut être modifiée entre 32 et 128. + + + + +Exemple + +Max Icon Size=72 + + + + + + +[Options - bibtex] + + +Ces paramètres doivent être placés dans le groupe Options - bibtex. + + + +lyxpipe + + +Ce paramètre indique l'adresse lyxpipe pour envoyer les citations bibliographiques. Il ne doit pas inclure le suffixe .in. + + + + +Exemple + +lyxpipe=$HOME/.lyx/lyxpipe + + + + + +[Export Options - PilotDB] + + +Ces paramètres doivent être placés dans le groupe Export Options - PilotDB. + + + +Charset + + +L'encodage des données exportées dans le fichier PilotDB peut être changé avec +ce paramètre. +La valeur par défaut est le jeu de caractères de la locale de l'utilisateur. + + + + +Exemple + +Charset=Windows-1250 + + + + + + + +Conversion de cqrqctères BibTeX + + +Lorsque des fichiers BibTeX sont i,portés ou exportés, certains caractères sont +convertis entre leur équivalent TeX et unicode. Ces tables de conversions sont +contenues dans le fichier bibtex-translation.xml, se +trouvant dans le repertoire de données installées par le logiciel. Ces tables +de conversion peuvent être modifiée librement. +L'élément clef contient le caractère Unicode, et les chaines contiennent les +équivalents TeX, qui peuvent être multiples. +Le premier est celui utilisé lors des exports qu format BibTeX. + + + + + {\`A} + \`{A} + +]]> + + + + + +Astuces XSLT + + +Quelques astuces pour écrire du XSLT pour traiter les données &xml; de &appname; : (à écrire). + + + + diff --git a/doc/fr/imdb-options.png b/doc/fr/imdb-options.png new file mode 100644 index 0000000..83c914b Binary files /dev/null and b/doc/fr/imdb-options.png differ diff --git a/doc/fr/importing-exporting.docbook b/doc/fr/importing-exporting.docbook new file mode 100644 index 0000000..61596fe --- /dev/null +++ b/doc/fr/importing-exporting.docbook @@ -0,0 +1,594 @@ + +Importer et exporter des données + + +&appname; peut importer et exporter une grande variété de fichiers de données, +ainsi que chercher des informations sur divers sites Internet. + + + +Importer depuis Internet + +&appname; peut chercher sur divers sites Internet en utilisant la +&fetch-dialog;. Les entrées peuvent être directement importées et ajoutées à +votre collection. Les différents fournisseurs peuvent être configurés via les +Options de sources de données. + + + +Les recherches peuvent utiliser cinq critères différents : +Titre, Personne, +ISBN, UPC/EAN ou +mot)clef. Tous les critères ne sont pas disponibles pour +certaines sources. Une fois la recherche débutée, le bouton +Chercher se transforme en bouton +Stop qui permet d'arrêter la recherche. Au fur et à +mesure que les résultats sont obtenus, ils sont automatiquement ajoutés à la +liste sous la boite de recherche. Cliquer sur une entrée affiche le résultat +sans l'ajouter à la collection. Cliquer sur le bouton Ajouter +l'entrée ajoute toutes les entrées sélectionnées à votre collection. +Cliquer sur le bouton Effacer efface tous les résultats +et initialise la recherche. + + + +La &fetch-dialog; &appname; + + +La &fetch-dialog; &appname; +La &fetch-dialog; &appname; + + + + +Seules les entrées ayant le même type de collection peuvent être trouvées. +La colonne Description fournit des informations +supplémentaires à propos de l'entrée, afin de différencier les vidéos de +différents formats ou les livres ayant des reliures différentes. Une fois +qu'une entrée a été ajoutée à la collection, une icône est ajoutée dans la +première colonne de la liste. + + + +Afin de faciliter l'utilisation de lecteurs de code barre, les recherches +peuvent porter sur plusieurs valeurs ISBN à la fois. Cocher la case +Recherche ISBN multiple désactive la boite de recherche et +active le bouton Liste ISBN..., qui ouvre une boite de +dialogue permettant d'entrer plusieurs lignes. Chaque numéro ISBN doit être sur +une ligne différente. Après avoir fermé la boite de dialogue, la mise en forme +de chaque numéro ISBN est vérifiée. Le procédé de validation ISBN permet de +convertir les valeurs EAN à 13 chiffres, ainsi que les codes +UPC au format ISBN classique. La liste de numéros ISBN peut +également être lue à partir d'un fichier texte. + + + + + +Importer des données + + +&appname; propose trois différentes actions lors de l'import de données. +Remplacer la collection indique que la collection ouverte +doit être fermée, et une nouvelle créée à partir des données importées. +Ajouter à la collection indique à &appname; d'ajouter +toutes les entrées de la collection importée à celle ouverte, et d'ajouter les +champs manquant. +Fusionner avec la collection ouverte a le même effet +qu'ajouter ; mais chaque entrée importée est comparée avec celles existant déjà, +et celles en double sont ignorées. +Il est prévu dans le futur d'améliorer l'algorithme pour identifier les +entrées en double ; mais pour le moment, en dehors des collections musicales, +tous les champs doivent être identiques. +Pour les collections musicales, &appname; compare seulement l'artiste et +l'album, et les plages sont fusionnées pour les entrées correspondantes. +L'import de fichiers audio peut +générer des listes de titres en fusionnant les entrées. + + + +Importer des données &appname; + + +D'autres fichiers de données &appname; peuvent être importés. Remplacer la +collection actuelle en important un fichier &appname; donne le même résultat +qu'une simple ouverture du fichier. +L'intérêt d'importer des données &appname; est principalement pour les ajouter +ou les fusionner deux collections ensemble. + + + + +Importer des données CSV + + +Les valeurs séparées par des virgules (CSV) sont un moyen courant d'importer +et d'exporter des données tabulaires. +Les différentes valeurs de champs sont séparées par des virgules, chaque entrée +occupant une ligne. +Les titres des champs peuvent être inclus comme en-tête en première ligne. +N'importe quel caractère ou chaîne de caractère autre que la virgule peut +également être utilisé pour délimiter les champs. + + + +La boite de dialogue d'import CVS + + +La boite de dialogue d'import CVS +La boite de dialogue d'import CVS + + + + +Commencer par sélectionner le type de collection que vous souhaitez importer. +Si vous ajoutez ou fusionnez avec la collection ouverte, le type est limité à +celui la collection courante. Si la première ligne du fichier CSV contient les +titres des champs, cochez la case correspondante et l'outil d'import comparera +automatiquement les titres avec ceux des champs de la collection ouverte. Si +les titres concordent, l'en-tête de cette colonne change pour indiquer que cette +colonne a été assignée à un champ. Si le fichier utilise un autre séparateur +que la virgule, assurez-vous de changer l'option en conséquence. + + + +Pour que &appname; puisse importer correctement le fichier, il doit connaître +la correspondance entre les champs et les numéros de colonne. Si la +colonne a seulement un nombre dans son en-tête, les données de cette colonne ne seront pas importées. Vous devez assigner un champ à chaque colonne +en sélectionnant une colonne, soit en cliquant dessus, soit en changeant le +numéro de colonne manuellement, puis en sélectionnant le champ à y associer +depuis la liste déroulante et en cliquant sur le bouton Assigner le +champ. Si vous souhaitez ajouter un nouveau champ à la collection, +la dernière entrée du menu déroulant ouvre la +&fields-dialog;. + + + +Seules les cinq premières lignes du fichier CSV importé sont affichées dans la +boite de dialogue. + + + + + +Importer les données d'un CD audio + + +&appname;peut utiliser le service +freedb.org pour trouver des informations +à propos d'un CD, y compris la liste des titres. En fonction +de la distribution que vous utilisez, les paramètres d'accès à ce service +peuvent être configurés dans le centre de contrôle &kde;. L'artiste et le titre +du CD, le genre, l'année et la liste des titres sont tous ajoutés. + + + +De plus, si le disque est de type CD-Text, les informations contenues sont lues +et ajoutées à l'entrée importée. + + + + +Importer les données d'un fichier audio + + +&appname; peut parcourir un répertoire et lire les tags de formats de fichiers +audio communs, tels que mp3 ou +ogg. Les titres sont ajoutés à une +collection musicale, dans laquelle chaque entrée représente un album. +Si le fichier musical contient un numéro de piste, le titre est ajouté a la +position correcte dans la liste de l'album. +L'artiste et le genre de musique sont également ajoutés à l'entrée. +Si les données contiennent des commentaires, ceux-ci sont ajoutés au champ +commentaires de l'entrée, précédés du nom de fichier. + + + +De plus, si un répertoire contient un ficher .directory et +que le nom du répertoire concorde avec le titre d'un album, l'entrée +Icon du fichier desktop est utilisée en tant que couverture +de l'album. + + + +L'import de méta-données de fichiers audio peut être fait en parcourant un +répertoire de façon récursive pour trouver tous les fichiers audio contenus dans +ce répertoire. Cependant, les liens symboliques ne sont pas suivis. &appname; +utilise la bibliothèque +TagLib pour +lire les données des fichiers audio, et peut donc importer les données de tous +les formats reconnus par TagLib. + + + + + +Importer des bibliothèques Alexandria + + +Alexandria est un gestionnaire de collection de livres pour le bureau +Gnome. L'importeur offre la +possibilité d'importer les bibliothèques trouvées dans +$HOME/.alexandria/. + + + + + +Importer des données BibTeX + + +BibTeX est un format de bibliographie utilisé avec le système de préparation +de documents LaTeX. Différents types de références bibliographiques peuvent +être incluses dans le fichier. &appname; importe les fichiers BibTeX sous forme +de collection bibliographique. + + + +Si l'outil d'import BibTeX rencontre des champs dans le fichier qui ne sont pas +dans la collection bibliographique par défaut, ils sont ajoutés en tant que +champs de type Texte Simple; avec deux exceptions. +Si la valeur du champ contient plus de 100 caractères, il est transformé en +champs de type Paragraphe. +Si la valeur du champs contient un &URL; ou une référence à un fichier, un +champs de type URL est créé. +&appname; utilise une copie interne de la +bibliothèque btparse +pour traiter les fichier BibTeX. + + + + +Importer des données BibTeXML + + +BibTeXML est une représentation +&xml; de données BibTeX. Les données importées d'un fichier BibTeXML sont +traitées de la même manière que les données BibTeX. + + + + + +Importer des données MODS + + +MODS +est un format pour représenter divers types de collections. Pour le moment, +seuls les livres peuvent être importés dans &appname;. + + + + + +Importer des données RIS + +Le format +RIS est un format de fichier bibliographique utilisé +entre autres par Référence Manager. &appname; les +fichiers RIS en tant que collection bibliographique. + + + + +Importer des données GCfilms + + +GCfilms +est un gestionnaire de collection de films. Normalement, les fichiers de données +GCfilms se trouvent dans le répertoire +$HOME/.local/share/gcfilms/. + + + + + +Importer une liste de fichiers + + +Le meilleur moyen de créer un catalogue de +fichiers est d'importer le contenu d'un répertoire. La recherche dans le +répertoire peut être récursive, pour ajouter tous les fichiers trouvés. +L'outil d'import est particulièrement utile pour les listes de sauvegardes et +les catalogues de fichiers, tels que les CD or +DVD. De plus, des prévisualisations en image des fichiers +peuvent être créées. Cependant, ceci peut prendre du temps s'il est nécessaire +de lire un nombre important de fichiers. Les prévisualisations sont du même +type que celles affichées dans le gestionnaire de fichiers &kde;. + + + + +Importer des données &xml; via XSLT + + +N'importe quel fichier peut être importé dans &appname;, pourvu qu'il existe une +feuille de style XSL disponible pour convertir le fichier au format &appname;. +&appname; charge automatiquement la feuille de style et effectue le traitement +XSLT nécessaire pour charger le fichier &xml;. + + + + + + +Exporter des données + + +Lors de l'export de données de la collection, les valeurs des entrées peuvent +être exportées telles qu'elles ont été créées, ou avec la +mise en forme automatique fournie par +&appname;. De plus, l'export peut être limité aux entrées sélectionnées, la +barre d'état indiquant le nombre d'entrées +sélectionnées. + + + +Les fichiers texte exportés, tels que BibTeX ou CSV, peuvent utiliser l'encodage +de caractères Unicode (UTF-8) ou celui de la locale du système d'exploitation. + + + +Options d'export générales + + +Options d'export générales + + + + +Exporter en &xml; + + +Le format de fichier pour &appname; est un fichier &xml; compressé au format +zip. Exporter en &xml; crée le fichier &xml; sans le compresser. Les images +peuvent être intégrées dans le fichier &xml; sous forme de donnée encodée au +format base64 dans un élément image. + + + + +Exporter au format Zip + + +Le format de fichier standard pour &appname; est un fichier zip, contenant le +fichier de collection &xml;, et, si souhaité, toutes les images référencées +dans la collection. Si les images sont conservées dans le répertoire de +l'application, exporter au format Zip créera un fichier de données contenant +toutes les images de la collection. + + + + +Exporter en HTML + + +L'export HTML utilise la feuille de style tellico2html.xsl. +Les images sont exportées dans un répertoire portant le même nom que le fichier +HTML avec le suffixe _files. + + + +Le format par défaut est similaire à celui pour l'impression et permet de +modifier le code HTML de plusieurs manières. Les en-tête des champs peuvent +être imprimés en haut de chaque colonne ; malheureusement &kde; ne permet pas +encore de répéter les en-tête des tableaux sur chaque page. Les entrées peuvent +être regroupées de la même manière que dans la &group-view;. + + + +De plus, des fichiers individuels peuvent être créés pour chaque entrée de la +collection, avec les liens générés dans le fichier HTML racine. Les fichiers +d'entrées sont créés dans le même répertoire que les images. +Les fichiers d'entrées HTML utilisent la feuille de style courante, comme dans +la &entry-view;. + + + +Options d'export HTML + + +Options d'export HTML + + + + + +Exporter en CSV + + +Les valeurs séparées par des virgules (CSV) sont un moyen courant d'importer +et d'exporter des données tabulaires. Les différentes valeurs de champs sont +séparées par des virgules, chaque entrée occupant une ligne. Les titres des +champs peuvent être inclus comme en-tête en première ligne. N'importe quel +caractère ou chaîne de caractère autre que la virgule peut également être +utilisé pour délimiter les champs. + + + +Options d'export CSV + + +Options d'export CSV + + + + + +Exporter en Pilot-DB + + +Pilot-DB est un format de +base de données pour Palm OS. Diverses applications de bureau peuvent lire et +écrire les fichiers Pilot-DB. Les fichiers +.pdb exportés peuvent être transférés vers +un PDA et utilisés directement. Pour le moment, &appname; ne peut pas importer +de fichier Pilot-DB. + + + +Options d'export Pilot-DB Export + + +Options d'export Pilot-DB Export + + + + + + +Exporting Alexandria + + +Alexandria +est un outil de gestion de bibliothèques pour l'environnement de bureau +GNOME. &appname; peut importer une +partie limitée des champs des collections de livres vers le point +d'enregistrement par défaut des données Alexandria. + + + + + +Exporting ONIX + + +ONIX est un format XML +pour la représentation et transmettre les informations des livres dans un cadre +industriel, essentiellement pour les vendeurs. &appname; peut exporter des +collections de livres en utilisant un sous-ensemble d'ONIX. + + + + + +Exporter en BibTeX + + +Lors de l'export en format +BibTeX, +les valeurs de champs peuvent être échappées avec des parenthèses ou des +guillemets. Si des macros sont utilisées dans la collection, elles peuvent être exportées en tant que macros ou appliquées. Pour les champs de type &URL;, +&appname; peut peut inclure les valeurs du champs dans un tag +\url{...}. Enfin, les entrées de contenant pas de clef de +citation peuvent être ignorées au lieu de voir des clefs automatiquement +générées par &appname;. + + + +Options d'export BibTeX + + +Options d'export BibTeX + + + + + +Exporter en BibTeXML + + +Bibtexml est un format +permettant de conserver des données BibTeX au format XML. + + + + + +Exporting GCfilms + + +GCfilms +est un autre outil de gestion de collection de fil,s. &appname; peut exporter +un nombre limité de champs d'une collection de vidéos vers un fichier GCfilms. + + + + + +Exporter en &xml; via &xslt; + + +Enfin, &appname; est capable de traiter sa représentation &xml; interne des +données de la collection avec une feuille de style XSL externe avant d'exporter. +Ce type d'opération peut être utile pour générer des rapports en texte ou +d'autres types de fichiers. + + + + + + +Travailler avec des citations + +Lorsque vous travaillez avec une +bibliographie, les citations de l'entrée +sélectionnée peuvent être générées et utilisées par d'autres applications. Une +citation dans le format BibTeX peut être copiée vers le presse-papier, puis +collée dans un fichier LaTeX. Les citations BibTeX peuvent également être +transmises à une application externe telle que LyX +ou Kile grâce à ce que l'on appelle des +lyxpipe. +Enfin une gestion limitée de l'export vers +OpenOffice.org Writer est disponible. + + + +Travailler avec OpenOffice.org + +&appname; dispose d'une gestion limitée de l'envoi de citation vers +OpenOffice.org Writer et de la mise à jour de la +bibliographie d'un document. Un greffon spécifique est utilisé, et si ce +dernier est disponible, le menu permettant de citer une entrée dans +Writer est disponible. S'il ne l'est pas, c'est que +&appname; n'a pas pu trouver ou charger le greffon. Plus d'informations +concernant la compilation de &appname; avec la gestion de OpenOffice.org +activée sont disponibles dans +une section ultérieure.. + + + +OpenOffice.org doit être configuré pour permettre +les interactions avec d'autres applications. +Deux méthodes sont disponibles : les tuyaux ou TCP/IP. Les tuyaux sont plus +simples et plus rapides. Pour lancer Writer et s'y +connecter a l'aide de tuyaux, la commande suivante peut être utilisée : + + +% oowriter "-accept=pipe,name=OOo_pipe;urp;StarOffice.ServiceManager" + + +Le tuyau ou le port TCP peuvent être configurés à chaque fois que +OpenOffice.org est exécuté. Consultez +la documentation OpenOffice.org +pour plus de détails. + + + +Pour insérer une citation, sélectionnez une entrée, puis utilisez +Citer l'entrée dans OpenOffice.org. +Writer doit déjà être en cours d'exécution. +&appname; tentera de s'y connecter. En cas d'échec, il vous demandera plus +d'informations concernant la connexion. + + + +Boite de dialogue de connexion OpenOffice.org Connection Dialog + + +Boite de dialogue de connexion OpenOffice.org Connection Dialog + + + + +Sélectionnez le type de connexion, soit tuyau ou TCP!IP. Puis entrez le nom +du tuyau, ou le nom d'hôte et le port TCP. +&appname; conservera en mémoire vos paramètres de connexion pour les futures +utilisations. + + + + + + + diff --git a/doc/fr/index.docbook b/doc/fr/index.docbook new file mode 100644 index 0000000..7d41871 --- /dev/null +++ b/doc/fr/index.docbook @@ -0,0 +1,452 @@ + +Tellico'> + + + + + + + + + XML"> + XSLT"> + HTML"> + CSS"> + + Vue de groupe"> + Vue en colonnes"> + Vue des entrées"> + Éditeur d'entrée"> + Vue d'icônes"> + Boite de dialogue de champs de collection"> + Boite de dialogue de recherche sur Internet"> + Boite de dialogue de configuration"> + Boite de dialogue de recherche"> + Filtre rapide"> + Boite de dialogue de filtre avancé"> + Boite de dialogue de prêt"> + Boite de dialogue de rapport"> + Boite de dialogue de raccourcis clavier"> + Boite de dialogue de configuration de la barre d'outils"> + Vue des filtres"> + Vue des prêts"> + + + + + + + + + + + +]> + + + + + + + + + + + + +26/01/2008 +1.3 + +Le guide &appname; + + + +Robby +Stephenson + +
&email;
+ + + + + + +Régis +Boudin +Traduction Française + +
regis@boudin.name
+ + + + + +2001 +2002 +2003 +2004 +2005 +2006 +2007 +2008 +&robby; + + + + + +Permission is granted to copy, distribute and/or modify this +document under the terms of the &GNU; Free Documentation License, +Version 1.1 or any later version published by the Free Software +Foundation; with &FDLInvariantSections;, with &FDLFrontCoverText;, and +with &FDLBackCoverText;. A copy of the license is included in +. + +The author of this documentation has also granted you permission to use +the content under the terms of the FreeBSD Documentation License, if you so choose. +See the notice in the licensing section. + + + + +This program is free software; you can redistribute it and/or +modify it under the terms of version 2 of the &GNU; General Public +License as published by the Free Software Foundation. + +This program is distributed in the hope that it will be +useful, but WITHOUT ANY WARRANTY; without even the implied warranty +of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the &GNU; +General Public License for more details. + +You should have received a copy of the &GNU; General Public +License along with this program; if not, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifh Floor, Boston, MA 02110-1301, USA. + + + + + + + +Ce document est le manuel d'utilisation pour &appname;, un logiciel de gestion de collection. + + + + + + +KDE +tellico +livre +bibliographie +film +collection +base de données +catalogue + + + + + + + +Introduction + + + + +&appname; + + +&appname; est un programme pour gérer des collections. Au départ simple +gestionnaire de collections de livres, il a été étendu pour intégrer des +modèles de collections de bibliographies, bandes dessinées, vidéos, +musique, monnaies, timbres, cartes, jeux vidéo, vins, jeux de plateau et +fichiers. De plus, des collections personnalisées peuvent être créées +pour tout ce qui peut être collectionné. + + + +Ce qu'est &appname; + + +&appname; garde la trace des entrées dans une collection, et propose un +moyen simple d'ajouter des information à chaque entrée. Il propose +plusieurs types de champs, et permet un nombre illimité de champs +définis par l'utilisateur. +Les entrées d'une collection peuvent être regroupées selon n'importe quel +champ pour une organisation facile, et les vues personnalisables affichent +autant d'informations que vous le souhaitez. + + + +Les entrées prêtées peuvent être suivies, avec une intégration possible +à &korganizer;. +Les collections peuvent être importées ou exportées depuis et vers +plusieurs formats, pour permettre un échange et une publication aisés +des données. + + + + + +Ce que &appname; n'est pas + + +&appname; n'est pas un lecteur audio ou vidéo. Il ne propose rien pour lire ou +modifier des fichiers multimédia. Il ne propose pas non plus de fonction pour +modifier les images. Bien que Tellico ait certaines fonctions pour +gérer des listes de bibliographies, ce n'est pas un outil complet de gestion de +références bibliographiques. &appname; n'a pas non plus la prétention d'avoir +toutes les capacités d'un outil de base de données relationnelle. + + + +Enfin, &appname; est un passe-temps pour l'auteur, et il n'est fait aucune +garantie concernant ses fonctionnalités, son utilisabilité ou quoi que ce soit +d'autre. &appname; est loin d'être un outil logiciel professionnel. Plus +d'informations sont disponibles dans la licence. + + + + + + +Terminologie + + +Collections + +Dans &appname;, le document est une collection. Une seule collection peut +exister dans chaque fichier &appname;. Une collection contient un nombre non +déterminé de champs et +d'entrées. +&appname; peut gérer douze types de collections génériques par défaut : livres, +entrées bibliographiques, bandes dessinées, vidéos, musique, cartes, pièces de +monnaie, timbres, jeux vidéos, vins, jeux de plateau et listes de fichiers. +En outre, un type de collection générique vide existe pour tout autre type +d'objet collectionnable. + + + + +Champs de collection + +Chaque collection peut avoir un nombre illimité de champs. &appname; gère onze +types de champs , permettant une large variété de données différentes. Les +champs peuvent être modifiés avec la +&fields-dialog; et sont expliqués plus en +détails dans la section types de champs. + + + + +Entrées de collection + + +Une entrée est un enregistrement de base dans &appname;. Chaque entrée contient +une valeur pour chaque champ de la collection. Une collection peut avoir un +nombre théoriquement illimité d'entrées. Cependant, la collection complète étant +conservée en mémoire, un trop grand nombre d'entrées ralentirait l'application. + + + +&appname; a été testé avec une collection de 10.000 entrées, et la vitesse +était satisfaisante. Cependant, si des images nombreuses ou volumineuses sont +incluses dans la collection, le chargement et le traitement seront ralentis +de façon importante. Les performances peuvent être améliorées en faisant en sorte +que &appname; conserve les images séparées du fichier de données lui-même ; soit +dans le répertoire de données de l'application, soit dans un répertoire situé +relativement au fichier lui-même. Plus d'informations sont disponibles +dans la section concernant la +configuration. + + + + + + + + +&fundamentals-chapter; + +&details-chapter; + +&importing-exporting-chapter; + +&advanced-chapter; + +&configuration-chapter; + +&menus-chapter; + +&hacking-chapter; + +&faqs-chapter; + + + + + +Crédits et Licence + + +&appname; + + +Program copyright 2001-2006 &robby; &email; + + + + + +Documentation copyright 2001-2006 &robby; &email; + + + + +This documentation is licensed under the terms of the &GNU; Free Documentation +License (GFDL). + +The author of this documentation has also granted you permission to use the content under the terms of the FreeBSD Documentation License, if you so choose. If you wish to allow use of your version of this content only under the terms of the FreeBSD Documentation License, and not to allow others to use your version of this file under the terms of the GFDL, indicate your decision by deleting the GFDL notice and and replacing it with the notice and other provisions required by the FreeBSD Documentation License. If you do not delete the GFDL notice above, a recipient may use your version of this file under the terms of either the GFDL or the FreeBSD Documentation License. + + + + +Installation + + +Comment obtenir &appname; + + +La page web de &appname; se trouve à +&homepage;. +Les mises à jour et les nouvelles informations s'y trouvent. + + + +Pré-requis + + + + +Pour pouvoir utiliser &appname;, vous avez besoin de KDE 3.2.x. +&appname; nécessite environ 5 mega-octets de mémoire ; mais cela peut varier +en fonction de vos platefome, configuration et essentiellement la taille de +votre collection. + + + +&kde; peut être trouvé sur le site web de +KDE. + + + + +Vous pouvez trouver une liste des dernières modifications sur &homepage;. + + + + +Compilation et installation + + +Pour compiler et installer &appname; sur votre système, entrez les commandes +suivantes à la racine de l'archive décompressée, la troisième devant être +effectuée en tant que root si vous souhaitez installer dans un répertoire système : + + +% ./configure +% make +% make install + + + +&appname; utilisant autoconf et automake, vous ne devriez pas avoir de +problème pour le compiler. Cependant, si vous deviez rencontrer des problèmes, +vous pouvez les rapporter à l'auteur à : &email;. + + +Compiller avec OpenOffice.org + +&appname; utilise greffon spécial pour communiquer avec OpenOffice.org, qui +n'est pas compilé par défaut. +Le kit de développement (SDK), disponible à +http://www.openoffice.org/dev_docs/source/sdk/, est nécessaire. + + +% ./configure =/usr/lib/openoffice =/usr/lib/openoffice/SDK + + +Vous devez utiliser le chemin correct des bibliothèques et du SDK +OpenOffice.org, bien sûr. + + + +De plus, certaines distributions peuvent nécessiter que vous modifiiez le +fichier /etc/ld.so.conf ou ajoutiez un fichier de +configuration dans le répertoire +/etc/ld.so.conf.d. +Vérifiez si le greffon OpenOffice.org fonctionne sans changer la configuration +d'abord. Si cela ne fonctionne pas, essayez d'ajouter le chemin le chemin +d'OpenOffice.org (le même que celui que vous avez utilisé avec le script +configure. +Si vous avez besoin de plus d'aide, utilisez la liste de discussion de &appname; + + + + + + + +&documentation.index; + + + diff --git a/doc/fr/loan-dialog.png b/doc/fr/loan-dialog.png new file mode 100644 index 0000000..59636d2 Binary files /dev/null and b/doc/fr/loan-dialog.png differ diff --git a/doc/fr/loan-view.png b/doc/fr/loan-view.png new file mode 100644 index 0000000..b022949 Binary files /dev/null and b/doc/fr/loan-view.png differ diff --git a/doc/fr/main-window.png b/doc/fr/main-window.png new file mode 100644 index 0000000..949fc01 Binary files /dev/null and b/doc/fr/main-window.png differ diff --git a/doc/fr/menus.docbook b/doc/fr/menus.docbook new file mode 100644 index 0000000..a3e676b --- /dev/null +++ b/doc/fr/menus.docbook @@ -0,0 +1,821 @@ + +Références des commandes + + + + +La fenêtre principale de &appname; + + +Chaque commande du menu est documentée ci-dessous. Lorsqu'il existe un racourci +clavier effectuant la même opération, le racourci par défaut est indiqué. + + + +Le menu <guimenu>Fichier</guimenu> + + + + + + + + Fichier + Nouveau + + + + +Cette commande crée une nouvelle collection. +&appname; reconnait douze types de collections +par défaut ; ainsi qu'une collection personalisable vide. + + + + + + + + &Ctrl;O + + Fichier + Ouvrir... + + + + +Cette commande ouvre un fichier &appname;. + + + + + + + Fichier + Ouvrir un fichier récent + + + + +Cette commande ouvre un fichier depuis un sous-menu +contenant une liste des fichiers récement ouverts. + + + + + + + + &Ctrl;S + + Fichier + Enregistrer... + + + + +Cette commande enregistre la collection. Si le fichier +est Sans titre, Enregistrer... +est équivalent à Enregistrer sous. Cette commande +est seulement disponible lorsque la collection a été modifiée. + + + + + + + Fichier + Enregistrer sous... + + + + +Cette commande enregistre collection dans un nouveau fichier. + + + + + + + + &Ctrl;P + + Fichier + Imprimer... + + + + +Cette commande imprime la collection. Les options +d'impression peuvent être configurées dans la &config-dialog;. + + + + + + + Fichier + Importer + + + + +Cette commande importe les données d'un autre fichier. +&appname; peut importer peut importer les données depuis +différents formats. + + + + + + + Fichier + Exporter + + + + +Cette commande exporte la collection dans un autre format. &appname; peut exporter les données dans +différents formats. + + + + + + + + &Ctrl;Q + + Fichier + Quitter + + + + +Cette commande ferme la fenêtre &appname;. Si la +collection a des changements non sauvegardés, il vous sera proposé de les +enregistrer avant de continuer. + + + + + + + + + +Le menu <guimenu>Editer</guimenu> + + + + + + + + + + &Ctrl;Z + + Editer + Annuler + + + + +Cette commande annule la dernière action. Toutes les +actions ne peuvent pas être annulées. + + + + + + + + &Ctrl;MajZ + + Editer + Refaire + + + + +Cette commande refait une opération précédement annulée. + + + + + + + + &Ctrl;X + + Editer + Couper + + + + +Cette commande efface le texte sélectioné, et +copie celui-ci dans le presse-papier. + + + + + + + + &Ctrl;C + + Editer + Copier + + + + +Cette commande copie le texte sélectioné dans le +presse-papier. + + + + + + + + &Ctrl;V + + Editer + Coller + + + + +Cette commande colle le texte du presse-papier, à la +position où se trouve le curseur. + + + + + + + + &Ctrl;A + + Editer + Selectioner tout + + + + +Cette commande selectione toutes les entrées de la +collection dans la &detailed-view;. + + + + + + + + &Ctrl;MajA + + Editer + Désélectioner + + + + +Cette commande ddésélectione toutes les entrées de la +collection. + + + + + + + Editer + Recherche Internet... + + + + +Cette commande ouvre la &fields-dialog; pour chercher et +importer des entrées depuis divers sites Internet, dont +Amazon.com. + + + + + + + + + + +Le menu <guimenu>Collection</guimenu> + + + + + + + + + &Ctrl;N + + Collection + Nouvelle entrée + + + + +Cette commande ouvre l'&entry-editor; pour éditer une nouvelle +entrée. + + + + + + + + &Ctrl;E + + Collection + Editer l'entrée + + + + +Cette commande ouvre l'&entry-editor; pour modifier les entrées sélectionées. + + + + + + + + &Ctrl;Y + + Collection + Copier l'entrée + + + + +Cette commande copie les entrées sélectionées en tant +que nouvelles entrées de la collection. + + + + + + + + &Ctrl;D + + Collection + Effacer l'entrée + + + + +Cette commande efface les entrées sélectionées. + + + + + + + Collection + Mettre à jour l'entrée + + + + +Ce sous-menu contient la liste des sources de données disponibles, et peut +être utilisé pour demander des informations et +mettre à jour les entrées sélectionées. + + + + + + + Collection + Prêter + + + + +Cette commande ouvre une boîte de dialogue pour prêter les +entrées sélectionées.. + + + + + + + Collection + Retour de prêt + + + + +Cette commande marque comme rendues les entrées sélectionées qui +on été prêtées. + + + + + + + + &Ctrl;R + + Collection + Renommer la collection + + + + +Cette commande ouvre une boîte de dialogue permettant de renommer +la collection. + + + + + + + + &Ctrl;U + + Collection + Champs de la collection... + + + + +Cette commande ouvre la &fields-dialog;. + + + + + + + + &Ctrl;U + + Collection + Générer des rapports... + + + + +Cette commande ouvre la &report-dialog; pour générer des +rapports concernant la collection. + + + + + + + Collection + Convertir en bibliographie + + + + +Cette commande convertit une collection de livres en +bibliographie, en ajoutant certains champs nécessaires à l'export au +format BibTeX ; et est uniquement disponible pour les collection de +livres. + + + + + + + Collection + Macros... + + + + +Cette commande ouvre une boîte de dialogue pour modifier les +macros BibTeX dans la collection. Elle est uniquement disponible pour +les bibliographies. + + + + + + + Collection + Copier la citation BibTeX + + + + +Cette commande copie une citation au format BibTeX dans +le presse-papier, afin qu"elle puisse être collée dans un document LaTeX. + + + + + + + Collection + Citer l'entrée dans Lyx + + + + +Cette commande envoie une citation des entrées +sélectionées vers ce qu'on appelle un +lyxpipe +pour l'utiliser dans LyX, +Kile, ou d'autres applications LaTeX. Cette commande +est seulement disponible pour les bibliographies. + + + + + + + Collection + Citer l'entrée dans OpenOffice.org + + + + +Cette commande envoie une citationn des entrées +sélectionées vers OpenOffice.org Writer. +Cette commande est seulement disponible pour les bibliographies, lorsque le +module OpenOffice.org est disponible. + + + + + + + + + + +Le menu <guimenu>Paramètres</guimenu> + + + + + + + + Paramètres + Barres d'outils + + + + +Cette commande permet d'afficher ou masquer les différentes +barres d'outils. + + + + + + + Paramètres + Afficher la barre d'état + + + + +Cette commande permet d'afficher ou masquer la barre +d'état. + + + + + + + Paramètres + Afficher la &group-view; + + + + +Cette commande permet d'afficher ou masquer la +&group-view;. + + + + + + + Paramètres + Afficher l' &entry-editor; + + + + +Cette commande permet d'afficher ou masquer +l'&entry-editor;. + + + + + + + Paramètres + Afficher la &entry-view; + + + + +Cette commande permet d'afficher ou masquer la +&entry-view;. + + + + + + + Paramètres + Sélection de groupe + + + + +Cette commande permet de changer le champ utilisé pour grouper +les entrées de la collection. + + + + + + + + &Ctrl;J + + Paramètres + Filtre avancé... + + + + +Cette commande ouvre la &filter-dialog;. + + + + + + + Paramètres + Configurer les racourcis... + + + + +Cette commande ouvre la &shortcut-dialog; &kde;. + + + + + + + Paramètres + Configurer les barres d'outils... + + + + +Cette commande ouvre la &toolbar-dialog; &kde;. + + + + + + + Paramètres + Configurer &appname;... + + + + +Cette commande ouvre la &config-dialog; &appname;. + + + + + + + + + +Le menu <guimenu>Aide</guimenu> + + + + + + + + Aide + Manuel &appname; + + + + +Cette commande ouvre le manuel de &appname;. + + + + + + + + MajF1 + + Aide + Qu'est-ce? + + + + +Cette commande transforme le curseur de la souris en flèche avec +un point d'intérogation. Cliquer sur les différents éléments de la +fenêtre affichera une bulle d'aide expliquant à quoi sert l'élément. + + + + + + + Aide + Astuce du jour + + + + +Cette commande ouvre la boîte de dialogue de l'astuce du +jour. Vous pouvez ainsi parcourir toutes les astuces à l'aide des +boutons de cette boîte de dialogue. + + + + + + + Aide + Rapporter un boggue... + + + + +Cette commande ouvre la boîte de dialogue de rapport de +boggue. Si vous trouvez un boggue ou un problème, si vous avez une +idée pour améliorer le logiciel ou corriger sa traduction, utilisez cette interface pour envoyer un message à son auteur. + + + + + + + Aide + A propos de &appname; + + + + +Cette commande ouvre la boîte de dialogue à propos de +&appname;, affichant la version et les informations de l'auteur de +l'application. + + + + + + + Aide + A propos de &kde; + + + + +Cette commande ouvre la boîte de dialogue à propos de +&kde;, affichant la version de &kde; et d'autres informations à +propos de l'environement de bureau. + + + + + + + + + + diff --git a/doc/fr/openoffice-dialog.png b/doc/fr/openoffice-dialog.png new file mode 100644 index 0000000..a2a2b40 Binary files /dev/null and b/doc/fr/openoffice-dialog.png differ diff --git a/doc/fr/print-options.png b/doc/fr/print-options.png new file mode 100644 index 0000000..f99fe33 Binary files /dev/null and b/doc/fr/print-options.png differ diff --git a/doc/fr/report-dialog.png b/doc/fr/report-dialog.png new file mode 100644 index 0000000..78364ac Binary files /dev/null and b/doc/fr/report-dialog.png differ diff --git a/doc/fr/source-options.png b/doc/fr/source-options.png new file mode 100644 index 0000000..3d37dd5 Binary files /dev/null and b/doc/fr/source-options.png differ diff --git a/doc/fr/sru-options.png b/doc/fr/sru-options.png new file mode 100644 index 0000000..d699fa8 Binary files /dev/null and b/doc/fr/sru-options.png differ diff --git a/doc/fr/template-options.png b/doc/fr/template-options.png new file mode 100644 index 0000000..596e6c7 Binary files /dev/null and b/doc/fr/template-options.png differ diff --git a/doc/fr/z3950-options.png b/doc/fr/z3950-options.png new file mode 100644 index 0000000..89264e7 Binary files /dev/null and b/doc/fr/z3950-options.png differ -- cgit v1.2.1