alexandria-book-collection-manager 0.6.9.pre1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gitignore +10 -0
- data/.rubocop.yml +68 -0
- data/.rubocop_todo.yml +200 -0
- data/CHANGELOG.md +23 -0
- data/COPYING +339 -0
- data/ChangeLog.0 +3598 -0
- data/Gemfile +9 -0
- data/INSTALL.rdoc +156 -0
- data/PACKAGING +36 -0
- data/README.md +88 -0
- data/RELEASE_CHECKLIST +18 -0
- data/Rakefile +264 -0
- data/TODO +24 -0
- data/alexandria-book-collection-manager.gemspec +35 -0
- data/alexandria.desktop.in +10 -0
- data/bin/alexandria +82 -0
- data/doc/AUTHORS +60 -0
- data/doc/BUGS +31 -0
- data/doc/FAQ +369 -0
- data/doc/HACKING +19 -0
- data/doc/NEWS +341 -0
- data/doc/alexandria.1 +120 -0
- data/doc/cuecat_support.rdoc +67 -0
- data/lib/alexandria.rb +85 -0
- data/lib/alexandria/about.rb +82 -0
- data/lib/alexandria/book_providers.rb +411 -0
- data/lib/alexandria/book_providers/adlibris.rb +235 -0
- data/lib/alexandria/book_providers/amazon_aws.rb +261 -0
- data/lib/alexandria/book_providers/amazon_ecs_util.rb +405 -0
- data/lib/alexandria/book_providers/barnes_and_noble.rb +229 -0
- data/lib/alexandria/book_providers/bol_it.rb +162 -0
- data/lib/alexandria/book_providers/deastore.rb +277 -0
- data/lib/alexandria/book_providers/douban.rb +135 -0
- data/lib/alexandria/book_providers/ibs_it.rb +149 -0
- data/lib/alexandria/book_providers/mcu.rb +177 -0
- data/lib/alexandria/book_providers/proxis.rb +205 -0
- data/lib/alexandria/book_providers/pseudomarc.rb +185 -0
- data/lib/alexandria/book_providers/renaud.rb +142 -0
- data/lib/alexandria/book_providers/siciliano.rb +271 -0
- data/lib/alexandria/book_providers/thalia.rb +197 -0
- data/lib/alexandria/book_providers/web.rb +59 -0
- data/lib/alexandria/book_providers/webster_it.rb +173 -0
- data/lib/alexandria/book_providers/worldcat.rb +251 -0
- data/lib/alexandria/book_providers/z3950.rb +422 -0
- data/lib/alexandria/config.rb +8 -0
- data/lib/alexandria/console.rb +31 -0
- data/lib/alexandria/execution_queue.rb +96 -0
- data/lib/alexandria/export_library.rb +536 -0
- data/lib/alexandria/import_library.rb +316 -0
- data/lib/alexandria/import_library_csv.rb +270 -0
- data/lib/alexandria/logging.rb +159 -0
- data/lib/alexandria/models/book.rb +72 -0
- data/lib/alexandria/models/library.rb +714 -0
- data/lib/alexandria/net.rb +53 -0
- data/lib/alexandria/preferences.rb +324 -0
- data/lib/alexandria/scanners.rb +42 -0
- data/lib/alexandria/scanners/cuecat.rb +118 -0
- data/lib/alexandria/scanners/keyboard.rb +57 -0
- data/lib/alexandria/smart_library.rb +525 -0
- data/lib/alexandria/ui.rb +53 -0
- data/lib/alexandria/ui/builder_base.rb +43 -0
- data/lib/alexandria/ui/callbacks.rb +389 -0
- data/lib/alexandria/ui/completion_models.rb +228 -0
- data/lib/alexandria/ui/dialogs/about_dialog.rb +59 -0
- data/lib/alexandria/ui/dialogs/acquire_dialog.rb +640 -0
- data/lib/alexandria/ui/dialogs/alert_dialog.rb +68 -0
- data/lib/alexandria/ui/dialogs/bad_isbns_dialog.rb +43 -0
- data/lib/alexandria/ui/dialogs/barcode_animation.rb +159 -0
- data/lib/alexandria/ui/dialogs/book_properties_dialog.rb +210 -0
- data/lib/alexandria/ui/dialogs/book_properties_dialog_base.rb +432 -0
- data/lib/alexandria/ui/dialogs/export_dialog.rb +172 -0
- data/lib/alexandria/ui/dialogs/import_dialog.rb +205 -0
- data/lib/alexandria/ui/dialogs/misc_dialogs.rb +85 -0
- data/lib/alexandria/ui/dialogs/new_book_dialog.rb +639 -0
- data/lib/alexandria/ui/dialogs/new_book_dialog_manual.rb +153 -0
- data/lib/alexandria/ui/dialogs/new_smart_library_dialog.rb +67 -0
- data/lib/alexandria/ui/dialogs/preferences_dialog.rb +587 -0
- data/lib/alexandria/ui/dialogs/smart_library_properties_dialog.rb +56 -0
- data/lib/alexandria/ui/dialogs/smart_library_properties_dialog_base.rb +432 -0
- data/lib/alexandria/ui/dndable.rb +81 -0
- data/lib/alexandria/ui/gtk_thread_help.rb +88 -0
- data/lib/alexandria/ui/icons.rb +100 -0
- data/lib/alexandria/ui/iconview.rb +91 -0
- data/lib/alexandria/ui/iconview_tooltips.rb +162 -0
- data/lib/alexandria/ui/init.rb +93 -0
- data/lib/alexandria/ui/libraries_combo.rb +75 -0
- data/lib/alexandria/ui/listview.rb +310 -0
- data/lib/alexandria/ui/main_app.rb +67 -0
- data/lib/alexandria/ui/multi_drag_treeview.rb +150 -0
- data/lib/alexandria/ui/sidepane.rb +194 -0
- data/lib/alexandria/ui/sound.rb +107 -0
- data/lib/alexandria/ui/ui_manager.rb +1308 -0
- data/lib/alexandria/undo_manager.rb +78 -0
- data/lib/alexandria/utils.rb +30 -0
- data/lib/alexandria/version.rb +24 -0
- data/lib/alexandria/web_themes.rb +75 -0
- data/misc/sounds/README +15 -0
- data/misc/sounds/bad_scan.csd +62 -0
- data/misc/sounds/good_scan.csd +61 -0
- data/misc/sounds/scanning.csd +46 -0
- data/po/ChangeLog +488 -0
- data/po/Makefile +44 -0
- data/po/README +29 -0
- data/po/commit-po +72 -0
- data/po/cs.po +1437 -0
- data/po/cy.po +1521 -0
- data/po/de.po +1400 -0
- data/po/el.po +1379 -0
- data/po/es.po +1376 -0
- data/po/fr.po +1420 -0
- data/po/ga.po +1359 -0
- data/po/gl.po +1397 -0
- data/po/it.po +1406 -0
- data/po/ja.po +1355 -0
- data/po/mk.po +1373 -0
- data/po/nb.po +1386 -0
- data/po/nl.po +1405 -0
- data/po/pl.po +1373 -0
- data/po/pt.po +1398 -0
- data/po/pt_BR.po +1409 -0
- data/po/ru.po +1372 -0
- data/po/sk.po +1380 -0
- data/po/sv.po +1402 -0
- data/po/uk.po +1423 -0
- data/po/zh_TW.po +1394 -0
- data/schemas/alexandria.schemas +300 -0
- data/share/alexandria/glade/acquire_dialog__builder.glade +201 -0
- data/share/alexandria/glade/book_properties_dialog__builder.glade +910 -0
- data/share/alexandria/glade/main_app__builder.glade +229 -0
- data/share/alexandria/glade/new_book_dialog__builder.glade +379 -0
- data/share/alexandria/glade/preferences_dialog__builder.glade +733 -0
- data/share/alexandria/icons/alexandria.png +0 -0
- data/share/alexandria/icons/alexandria_small.png +0 -0
- data/share/alexandria/icons/book.png +0 -0
- data/share/alexandria/icons/book_icon.png +0 -0
- data/share/alexandria/icons/book_small.png +0 -0
- data/share/alexandria/icons/cuecat.png +0 -0
- data/share/alexandria/icons/cuecat_inactive.png +0 -0
- data/share/alexandria/icons/favorite_tag.png +0 -0
- data/share/alexandria/icons/less.png +0 -0
- data/share/alexandria/icons/library.png +0 -0
- data/share/alexandria/icons/library_small.png +0 -0
- data/share/alexandria/icons/lookup.png +0 -0
- data/share/alexandria/icons/more.png +0 -0
- data/share/alexandria/icons/no_cover.png +0 -0
- data/share/alexandria/icons/smart_library.png +0 -0
- data/share/alexandria/icons/smart_library_small.png +0 -0
- data/share/alexandria/icons/star_set.png +0 -0
- data/share/alexandria/icons/star_unset.png +0 -0
- data/share/alexandria/icons/view_as_icons.png +0 -0
- data/share/alexandria/icons/view_as_list.png +0 -0
- data/share/alexandria/ui/menus.xml +91 -0
- data/share/alexandria/ui/popups.xml +91 -0
- data/share/alexandria/web-themes/clean/clean.css +85 -0
- data/share/alexandria/web-themes/clean/preview.jpg +0 -0
- data/share/alexandria/web-themes/list/list.css +105 -0
- data/share/alexandria/web-themes/list/preview.jpg +0 -0
- data/share/app-icon/16x16/alexandria.png +0 -0
- data/share/app-icon/16x16/alexandria.svg +263 -0
- data/share/app-icon/22x22/alexandria.png +0 -0
- data/share/app-icon/22x22/alexandria.svg +465 -0
- data/share/app-icon/24x24/alexandria.png +0 -0
- data/share/app-icon/32x32/alexandria.png +0 -0
- data/share/app-icon/32x32/alexandria.svg +813 -0
- data/share/app-icon/32x32/alexandria.xpm +241 -0
- data/share/app-icon/48x48/alexandria.png +0 -0
- data/share/app-icon/scalable/alexandria.svg +700 -0
- data/share/gnome/help/alexandria/C/about.xml +44 -0
- data/share/gnome/help/alexandria/C/adding-books.xml +339 -0
- data/share/gnome/help/alexandria/C/alexandria.xml +185 -0
- data/share/gnome/help/alexandria/C/bugs.xml +18 -0
- data/share/gnome/help/alexandria/C/editing-book-properties.xml +124 -0
- data/share/gnome/help/alexandria/C/exporting.xml +81 -0
- data/share/gnome/help/alexandria/C/figures/adding_books_acquire_from_scanner_process.png +0 -0
- data/share/gnome/help/alexandria/C/figures/adding_books_add_by_isbn.png +0 -0
- data/share/gnome/help/alexandria/C/figures/adding_books_isbn_import.png +0 -0
- data/share/gnome/help/alexandria/C/figures/adding_books_manual_details.png +0 -0
- data/share/gnome/help/alexandria/C/figures/adding_books_rename_library_after_import.png +0 -0
- data/share/gnome/help/alexandria/C/figures/adding_books_search_results.png +0 -0
- data/share/gnome/help/alexandria/C/figures/editing_book_properties_info.png +0 -0
- data/share/gnome/help/alexandria/C/figures/editing_book_properties_loaning.png +0 -0
- data/share/gnome/help/alexandria/C/figures/exporting_information_html.png +0 -0
- data/share/gnome/help/alexandria/C/figures/getting_started_first_launched.png +0 -0
- data/share/gnome/help/alexandria/C/figures/searching_filtering_views_list_view.png +0 -0
- data/share/gnome/help/alexandria/C/figures/searching_filtering_views_list_view_search.png +0 -0
- data/share/gnome/help/alexandria/C/figures/settings_providers_new_z3950.png +0 -0
- data/share/gnome/help/alexandria/C/figures/smart_libraries_new_smart_library.png +0 -0
- data/share/gnome/help/alexandria/C/figures/working_with_libraries_library_pane.png +0 -0
- data/share/gnome/help/alexandria/C/getting-started.xml +154 -0
- data/share/gnome/help/alexandria/C/gnu-fdl-1.2.xml +543 -0
- data/share/gnome/help/alexandria/C/introduction.xml +142 -0
- data/share/gnome/help/alexandria/C/searching.xml +90 -0
- data/share/gnome/help/alexandria/C/settings.xml +140 -0
- data/share/gnome/help/alexandria/C/smart-libraries.xml +160 -0
- data/share/gnome/help/alexandria/C/working-with-libraries.xml +76 -0
- data/share/gnome/help/alexandria/ChangeLog +99 -0
- data/share/gnome/help/alexandria/fr/alexandria.xml +2292 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_add_button.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_add_by_isbn_1.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_add_by_search_1.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_add_manually.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_add_z3950.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_close_button.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_edit_info.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_export_web_page.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_importing.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_library_pane.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_list_view.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_list_view_search.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_loaning.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_main_window.png +0 -0
- data/share/gnome/help/alexandria/fr/figures/alexandria_remove_button.png +0 -0
- data/share/gnome/help/alexandria/ja/about.xml +33 -0
- data/share/gnome/help/alexandria/ja/adding-books.xml +314 -0
- data/share/gnome/help/alexandria/ja/alexandria.xml +172 -0
- data/share/gnome/help/alexandria/ja/bugs.xml +11 -0
- data/share/gnome/help/alexandria/ja/editing-book-properties.xml +100 -0
- data/share/gnome/help/alexandria/ja/exporting.xml +98 -0
- data/share/gnome/help/alexandria/ja/figures/adding_books_acquire_from_scanner_process.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/adding_books_add_by_isbn.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/adding_books_isbn_import.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/adding_books_manual_details.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/adding_books_rename_library_after_import.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/adding_books_search_results.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/editing_book_properties_info.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/editing_book_properties_loaning.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/exporting_information_html.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/getting_started_first_launched.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/searching_filtering_views_list_view.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/searching_filtering_views_list_view_search.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/settings_providers_new_z3950.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/smart_libraries_new_smart_library.png +0 -0
- data/share/gnome/help/alexandria/ja/figures/working_with_libraries_library_pane.png +0 -0
- data/share/gnome/help/alexandria/ja/getting-started.xml +144 -0
- data/share/gnome/help/alexandria/ja/gnu-fdl-1.2.xml +541 -0
- data/share/gnome/help/alexandria/ja/introduction.xml +134 -0
- data/share/gnome/help/alexandria/ja/searching.xml +104 -0
- data/share/gnome/help/alexandria/ja/settings.xml +129 -0
- data/share/gnome/help/alexandria/ja/smart-libraries.xml +140 -0
- data/share/gnome/help/alexandria/ja/working-with-libraries.xml +88 -0
- data/share/menu/alexandria +7 -0
- data/share/omf/alexandria/alexandria-C.omf.in +27 -0
- data/share/omf/alexandria/alexandria-fr.omf.in +30 -0
- data/share/sounds/alexandria/bad_scan.ogg +0 -0
- data/share/sounds/alexandria/bad_scan.wav +0 -0
- data/share/sounds/alexandria/good_scan.ogg +0 -0
- data/share/sounds/alexandria/good_scan.wav +0 -0
- data/share/sounds/alexandria/scanning.ogg +0 -0
- data/share/sounds/alexandria/scanning.wav +0 -0
- data/spec/alexandria/library_spec.rb +205 -0
- data/spec/alexandria/preferences_spec.rb +22 -0
- data/spec/alexandria/scanners/cuecat_spec.rb +68 -0
- data/spec/alexandria/smart_library_spec.rb +22 -0
- data/spec/alexandria/ui/dialogs_spec.rb +90 -0
- data/spec/alexandria/ui/iconview_spec.rb +27 -0
- data/spec/alexandria/ui/listview_spec.rb +28 -0
- data/spec/alexandria/ui/main_app_spec.rb +48 -0
- data/spec/alexandria/ui/sidepane_spec.rb +27 -0
- data/spec/alexandria/ui/ui_manager_spec.rb +26 -0
- data/spec/alexandria/ui/ui_utilities_spec.rb +60 -0
- data/spec/alexandria/utilities_spec.rb +50 -0
- data/spec/data/libraries/0.6.1-noisbn/My Library/0201398257.yaml +10 -0
- data/spec/data/libraries/0.6.1-noisbn/My Library/1565920007.yaml +10 -0
- data/spec/data/libraries/0.6.1/My Library/0192812173.yaml +9 -0
- data/spec/data/libraries/0.6.1/My Library/0201398257.cover +0 -0
- data/spec/data/libraries/0.6.1/My Library/0201398257.yaml +10 -0
- data/spec/data/libraries/0.6.1/My Library/1565920007.yaml +10 -0
- data/spec/data/libraries/0.6.2/My Library/9780140266146.cover +0 -0
- data/spec/data/libraries/0.6.2/My Library/9780140266146.yaml +16 -0
- data/spec/data/libraries/0.6.2/My Library/9780140278781.cover +0 -0
- data/spec/data/libraries/0.6.2/My Library/9780140278781.yaml +21 -0
- data/spec/data/libraries/0.6.2/My Library/9780571147168.cover +0 -0
- data/spec/data/libraries/0.6.2/My Library/9780571147168.yaml +20 -0
- data/spec/data/libraries/0.6.2/My Library/9780575079038.cover +0 -0
- data/spec/data/libraries/0.6.2/My Library/9780575079038.yaml +20 -0
- data/spec/data/libraries/0.6.2/My Library/9780755322800.cover +0 -0
- data/spec/data/libraries/0.6.2/My Library/9780755322800.yaml +20 -0
- data/spec/spec_helper.rb +46 -0
- data/tasks/rdoc.rake +6 -0
- data/tasks/setup.rb +30 -0
- data/tasks/spec.rake +29 -0
- data/tasks/test.rake +38 -0
- data/test/application_test.rb +39 -0
- data/test/book_test.rb +34 -0
- data/test/data/isbns.txt +3 -0
- data/test/isbn_test.rb +68 -0
- data/test/providers_test.rb +254 -0
- data/test/test_helper.rb +42 -0
- data/util/rake/fileinstall.rb +313 -0
- data/util/rake/gettextgenerate.rb +158 -0
- data/util/rake/omfgenerate.rb +79 -0
- metadata +452 -0
@@ -0,0 +1,11 @@
|
|
1
|
+
<!-- ============= Bugs ================================== -->
|
2
|
+
<!-- This section is optional and is commented out by default.
|
3
|
+
You can use it to describe known bugs and limitations of the
|
4
|
+
program if there are any - please be frank and list all
|
5
|
+
problems you know of.
|
6
|
+
|
7
|
+
<section id="alexandria-bugs">
|
8
|
+
<title>Known Bugs and Limitations</title>
|
9
|
+
<para> </para>
|
10
|
+
</section>
|
11
|
+
-->
|
@@ -0,0 +1,100 @@
|
|
1
|
+
<!-- ============= Editing Book Properties Subsection =========== -->
|
2
|
+
|
3
|
+
<section id="editing-book-properties">
|
4
|
+
<title>本の設定を編集するには</title>
|
5
|
+
<para>&app; を使って本の情報を編集できます。
|
6
|
+
<itemizedlist>
|
7
|
+
<listitem><para><xref linkend="editing-info"/></para></listitem>
|
8
|
+
<listitem><para><xref linkend="changing-cover-image"/></para></listitem>
|
9
|
+
<listitem><para><xref linkend="loaning-books"/></para></listitem>
|
10
|
+
<listitem><para><xref linkend="editing-notes"/></para></listitem>
|
11
|
+
</itemizedlist></para>
|
12
|
+
|
13
|
+
<!-- ======== Editing information ========= -->
|
14
|
+
<section id="editing-info">
|
15
|
+
<title>基本的な情報を編集するには</title>
|
16
|
+
<para>本の情報を変更するには、メインウィンドの本の表紙画像をクリックするか、メニューの
|
17
|
+
<menuchoice><guimenu>ライブラリ</guimenu><guimenuitem>設定</guimenuitem></menuchoice>
|
18
|
+
を選択します。次のようなウィンドが表示されますので、本のタイトル、ISBN、作者、出版社、装丁、
|
19
|
+
評価を変更します。</para>
|
20
|
+
<figure id="editing-info-fig">
|
21
|
+
<title>&app; を使って本の情報を編集している様子</title>
|
22
|
+
<screenshot>
|
23
|
+
<mediaobject>
|
24
|
+
<imageobject>
|
25
|
+
<imagedata fileref="figures/editing_book_properties_info.png" format="PNG"/>
|
26
|
+
</imageobject>
|
27
|
+
<!-- EPS versions of the figures are not required at the moment. -->
|
28
|
+
<!--
|
29
|
+
<imageobject>
|
30
|
+
<imagedata fileref="figures/image.eps" format="EPS"/>
|
31
|
+
</imageobject>
|
32
|
+
-->
|
33
|
+
<textobject>
|
34
|
+
<phrase>&app; を表示中。本を編集しています。</phrase>
|
35
|
+
</textobject>
|
36
|
+
</mediaobject>
|
37
|
+
</screenshot>
|
38
|
+
</figure>
|
39
|
+
<para>作者を追加するには、作者一覧の横にある<guibutton>+</guibutton>
|
40
|
+
ボタンをクリックして、新しい名前を入力してください。作者を削除するには、名前を選択して、
|
41
|
+
<guibutton>-</guibutton> ボタンをクリックしてください。名前を編集するには、
|
42
|
+
名前のところを2回クリックしてください。</para>
|
43
|
+
<tip><para>星をクリックすることで本を評価できます。評価を消すには、
|
44
|
+
一番左の星のすぐ左をクリックしてください。あなたの好みの本(星が5つついた本)
|
45
|
+
はメインウィンドでアイコン一覧表示したときに、
|
46
|
+
アイコンの右上に小さなハートマークのアイコンがつきます。</para></tip>
|
47
|
+
</section>
|
48
|
+
|
49
|
+
<!-- ======== Changing cover images ========= -->
|
50
|
+
<section id="changing-cover-image">
|
51
|
+
<title>表紙画像を変更するには</title>
|
52
|
+
<para>本の表紙画像を変更するには、すでにつけてある表紙画像(表紙をつけていない場合は、
|
53
|
+
デフォルトの本の画像)をクリックしてください。標準的なファイル選択ダイアログが開きます。
|
54
|
+
あなたのコンピュータ上のファイルから画像ファイル(JPEG,PNG,GIFファイル)を選択して
|
55
|
+
<guibutton>開く</guibutton> のボタンをクリックしてください。選択した画像が
|
56
|
+
<guilabel>本の編集</guilabel> のダイアログのところに大きさを合わせて表示されます。</para>
|
57
|
+
</section>
|
58
|
+
|
59
|
+
<!-- ======== Loaning books ========= -->
|
60
|
+
<section id="loaning-books">
|
61
|
+
<title>本の貸し出しをするには</title>
|
62
|
+
<para>本に貸出中マークを付けるには、最初に<xref linkend="editing-info"/>
|
63
|
+
で述べた本の編集のダイアログを開きます。次に、<guilabel>貸し出し</guilabel>
|
64
|
+
のタブをクリックします。<guilabel>この本は貸し出し中です</guilabel>
|
65
|
+
のチェックボックスをクリックして貸し出し中であることにします。
|
66
|
+
<guilabel>誰に</guilabel>のところに、誰に本を貸し出したかを書けます。
|
67
|
+
<guilabel>いつから</guilabel>のドロップダウンメニューをクリックして、
|
68
|
+
本を貸し出した日を設定できます。</para>
|
69
|
+
<figure id="loaning-fig">
|
70
|
+
<title>&app; で本の貸し出し情報を付加している様子</title>
|
71
|
+
<screenshot>
|
72
|
+
<mediaobject>
|
73
|
+
<imageobject>
|
74
|
+
<imagedata fileref="figures/editing_book_properties_loaning.png" format="PNG"/>
|
75
|
+
</imageobject>
|
76
|
+
<!-- EPS versions of the figures are not required at the moment. -->
|
77
|
+
<!--
|
78
|
+
<imageobject>
|
79
|
+
<imagedata fileref="figures/image.eps" format="EPS"/>
|
80
|
+
</imageobject>
|
81
|
+
-->
|
82
|
+
<textobject>
|
83
|
+
<phrase>&app;を表示中です。本を貸し出しています。</phrase>
|
84
|
+
</textobject>
|
85
|
+
</mediaobject>
|
86
|
+
</screenshot>
|
87
|
+
</figure>
|
88
|
+
</section>
|
89
|
+
|
90
|
+
<!-- ========== Adding notes ========== -->
|
91
|
+
<section id="editing-notes">
|
92
|
+
<title>ノートの追加と更新をするには</title>
|
93
|
+
<para>&app; では、本に関する追加のノート(メモ)をつけることが出来ます。
|
94
|
+
例えば、個人的な書評や、有用なページの情報などです。
|
95
|
+
ノートを追加、編集するには、最初に<xref linkend="editing-info"/>
|
96
|
+
の本の編集のダイアログを開きます。次に、<guilabel>ノート</guilabel>のタブをクリックします。
|
97
|
+
ここにプレーンテキスト形式でノートを入力します。</para>
|
98
|
+
</section>
|
99
|
+
|
100
|
+
</section>
|
@@ -0,0 +1,98 @@
|
|
1
|
+
<!-- ============= Exporting information Subsection ============= -->
|
2
|
+
|
3
|
+
<section id="exporting">
|
4
|
+
<title>本の情報のエクスポートをするには</title>
|
5
|
+
<para>
|
6
|
+
&app; の中の本の情報を他のアプリケーションで利用できるよう、データをいくつかの
|
7
|
+
形式でエクスポート出来ます。
|
8
|
+
<itemizedlist>
|
9
|
+
<listitem><para><xref linkend="exporting-as-onix"/></para></listitem>
|
10
|
+
<listitem><para><xref linkend="exporting-as-Tellico"/></para></listitem>
|
11
|
+
<listitem><para><xref linkend="exporting-as-bibtex"/></para></listitem>
|
12
|
+
<listitem><para><xref linkend="exporting-as-plaintext"/></para></listitem>
|
13
|
+
<listitem><para><xref linkend="exporting-as-web-page"/>、XHTMLとCSSスタイルシートを使います</para></listitem>
|
14
|
+
</itemizedlist>
|
15
|
+
</para>
|
16
|
+
|
17
|
+
<section id="exporting-as-onix">
|
18
|
+
<title>ONIX圧縮アーカイブ形式でエクスポートする方法</title>
|
19
|
+
|
20
|
+
<para>
|
21
|
+
ONIXとは出版社や再販業者が本の情報(タイトル、価格、貢献者、書評など)を定義するのに
|
22
|
+
用いる国際標準です。ONIXに関する詳細な情報は、<ulink url="http://www.editeur.org/" type="http">http://www.editeur.org/</ulink> をご覧ください。
|
23
|
+
</para>
|
24
|
+
|
25
|
+
<para>
|
26
|
+
&app; はあなたの本の情報をすべて集め、個々の本をONIXファイル
|
27
|
+
(ONIXメッセージと呼ばれています)をアーカイブ形式(tar+bzip2)でエクスポートします。
|
28
|
+
ONIXアーカイブでエクスポートするには、メインメニューから
|
29
|
+
<menuchoice><guimenu>ライブラリ</guimenu><guimenuitem>エクスポート</guimenuitem>
|
30
|
+
</menuchoice>を選択し、<guilabel>エクスポートフォーマット</guilabel> メニューで、
|
31
|
+
<guimenuitem>Archived ONIX XML (.onix.tbz2)</guimenuitem>を選択します。
|
32
|
+
ファイル名を入力し、アーカイブを保存する場所を選択して、<guibutton>エクスポート</guibutton>
|
33
|
+
のボタンを押してください。
|
34
|
+
</para>
|
35
|
+
</section>
|
36
|
+
|
37
|
+
<section id="exporting-as-Tellico">
|
38
|
+
<title>圧縮Tellicoファイル形式でエクスポートする方法</title>
|
39
|
+
<para>
|
40
|
+
Tellicoは本や他のコレクションの情報を格納する標準的な
|
41
|
+
XMLベースのフォーマットです。&app; はTellico形式のフォーマットの情報をインポート
|
42
|
+
とエクスポートの両方が出来ます。
|
43
|
+
</para>
|
44
|
+
<para>
|
45
|
+
圧縮ファイル(.tc)としてライブラリをエクスポートするには、エクスポートの
|
46
|
+
ダイアログで、<guilabel>エクスポートフォーマット</guilabel>から、
|
47
|
+
<guimenuitem>Archived Tellico XML (.tc)</guimenuitem>を選んでください。
|
48
|
+
</para>
|
49
|
+
</section>
|
50
|
+
|
51
|
+
<section id="exporting-as-bibtex">
|
52
|
+
<title>BibTeX形式でエクスポートする方法</title>
|
53
|
+
<para>BibTeXは参考文献情報を格納するLaTeXベースのファイルフォーマットです。</para>
|
54
|
+
<para>BibTeX(.bib)形式でエクスポートするには、エクスポートのダイアログで、
|
55
|
+
<guilabel>エクスポートフォーマット</guilabel>から、<guimenuitem>BibTeX (.bib)</guimenuitem>を選んでください。</para>
|
56
|
+
</section>
|
57
|
+
|
58
|
+
<section id="exporting-as-plaintext">
|
59
|
+
<title>ISBNの一覧形式でエクスポートする方法</title>
|
60
|
+
<para>&app; はISBNの一覧をプレーンテキストでエクスポートできます。例えば別のマシーンに
|
61
|
+
データを移すときに使えます。ISBN一覧形式でエクスポートするには、
|
62
|
+
エクスポートのダイアログで、
|
63
|
+
<guilabel>エクスポートフォーマット</guilabel>から、<guimenuitem>ISBN list (.txt)</guimenuitem>を選んでください。</para>
|
64
|
+
</section>
|
65
|
+
|
66
|
+
<section id="exporting-as-web-page">
|
67
|
+
<title>ウェブページとしてエクスポートする方法</title>
|
68
|
+
<para>&app; はあなたのライブラリをそれぞれの本に表紙をつけて一覧形式で、ウェブページ
|
69
|
+
として作成できます。そのために、&app; は表紙画像と、XHTMLウェブページと、CSSスタイルシート
|
70
|
+
を生成します。ウェブページの見え方をカスタマイズするため、いくつかのスタイルシートを
|
71
|
+
選択できます。</para>
|
72
|
+
<para>ウェブページとしてライブラリをエクスポートするには、メインメニューから
|
73
|
+
<menuchoice><guimenu>ライブラリ</guimenu><guimenuitem>エクスポート</guimenuitem></menuchoice>を選択し、<guilabel>エクスポートフォーマット</guilabel>から、<guimenuitem>HTML Web Page (directory)</guimenuitem>を選んでください。次に、<guimenuitem>テーマ</guimenuitem>メニューからウェブページのスタイルまたはテーマを選択してください。</para>
|
74
|
+
<figure id="export-as-web-page-fig">
|
75
|
+
<title>&app; をつかってウェブページを作成している様子</title>
|
76
|
+
<screenshot>
|
77
|
+
<mediaobject>
|
78
|
+
<imageobject>
|
79
|
+
<imagedata fileref="figures/exporting_information_html.png" format="PNG"/>
|
80
|
+
</imageobject>
|
81
|
+
<!-- EPS versions of the figures are not required at the moment. -->
|
82
|
+
<!--
|
83
|
+
<imageobject>
|
84
|
+
<imagedata fileref="figures/image.eps" format="EPS"/>
|
85
|
+
</imageobject>
|
86
|
+
-->
|
87
|
+
<textobject>
|
88
|
+
<phrase>&app;を表示中。 ウェブページとしてライブラリをエクスポートしています。</phrase>
|
89
|
+
</textobject>
|
90
|
+
</mediaobject>
|
91
|
+
</screenshot>
|
92
|
+
</figure>
|
93
|
+
<para>ウェブページを保存するディレクトリ名を名前のところに入力し、<guibutton>エクスポート</guibutton>のボタンを押して保存します。</para>
|
94
|
+
<tip>
|
95
|
+
<para>現時点では Clean というテーマが1つだけ利用できます。</para>
|
96
|
+
</tip>
|
97
|
+
</section>
|
98
|
+
</section>
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
Binary file
|
@@ -0,0 +1,144 @@
|
|
1
|
+
<!-- =========== Getting Started ============================== -->
|
2
|
+
<!-- Use the Getting Started section to describe the steps required
|
3
|
+
to start the application and to describe the user interface components
|
4
|
+
of the application. If there is other information that it is important
|
5
|
+
for readers to know before they start using the application, you should
|
6
|
+
also include this information here.
|
7
|
+
If the information about how to get started is very short, you can
|
8
|
+
include it in the Introduction and omit this section. -->
|
9
|
+
<section id="getting-started">
|
10
|
+
<title>まず最初に</title>
|
11
|
+
<section id="start">
|
12
|
+
<title>&app;の起動方法</title>
|
13
|
+
<para>
|
14
|
+
<application>&app;</application> を起動するには、次のいずれかの方法で行います。
|
15
|
+
</para>
|
16
|
+
<variablelist>
|
17
|
+
<varlistentry>
|
18
|
+
<term><guimenu>アプリケーション</guimenu>メニューから</term>
|
19
|
+
<listitem>
|
20
|
+
<para>
|
21
|
+
<menuchoice>
|
22
|
+
<guisubmenu>オフィス</guisubmenu>
|
23
|
+
<guimenuitem>Alexandria ブック・コレクション・マネージャー</guimenuitem>
|
24
|
+
</menuchoice>を選択</para>
|
25
|
+
</listitem>
|
26
|
+
</varlistentry>
|
27
|
+
<varlistentry>
|
28
|
+
<term>Command line コマンドラインから</term>
|
29
|
+
<listitem>
|
30
|
+
<para>
|
31
|
+
コマンドラインから <application>&app;</application> を起動するには、
|
32
|
+
以下のコマンドを入力して、<keycap>Return</keycap>キーを押してください。
|
33
|
+
</para>
|
34
|
+
<para>
|
35
|
+
<command>alexandria</command>
|
36
|
+
</para>
|
37
|
+
</listitem>
|
38
|
+
</varlistentry>
|
39
|
+
</variablelist>
|
40
|
+
<para>起動後、&app; は最後に開いていたライブラリを開きます。</para>
|
41
|
+
|
42
|
+
</section>
|
43
|
+
<section id="when-start">
|
44
|
+
<title>&app;を起動したら</title>
|
45
|
+
<para><application>&app;</application> を起動した直後は次のような画面になっています。</para>
|
46
|
+
<!-- ==== Figure ==== -->
|
47
|
+
<figure id="mainwindow-fig">
|
48
|
+
<title>&app;起動画面</title>
|
49
|
+
<screenshot>
|
50
|
+
<mediaobject>
|
51
|
+
<imageobject>
|
52
|
+
<imagedata fileref="figures/getting_started_first_launched.png" format="PNG"/>
|
53
|
+
</imageobject>
|
54
|
+
<!-- EPS versions of the figures are not required at the moment. -->
|
55
|
+
<!--
|
56
|
+
<imageobject>
|
57
|
+
<imagedata fileref="figures/image.eps" format="EPS"/>
|
58
|
+
</imageobject>
|
59
|
+
-->
|
60
|
+
<textobject>
|
61
|
+
<phrase>&app; のメインウィンドを表示しています。
|
62
|
+
タイトルバー、メニューバー、ライブラリの一覧(高機能ライブラリの一覧を含む)があり、
|
63
|
+
本を表示する場所には本は1冊もありません。
|
64
|
+
メニューバーにはライブラリ、編集、表示、ヘルプのメニューがあります。</phrase>
|
65
|
+
</textobject>
|
66
|
+
</mediaobject>
|
67
|
+
</screenshot>
|
68
|
+
</figure>
|
69
|
+
|
70
|
+
<!-- ==== End of Figure ==== -->
|
71
|
+
<!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
|
72
|
+
<!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
|
73
|
+
|
74
|
+
<para>&app;のウィンド中の各要素の説明: </para>
|
75
|
+
|
76
|
+
<variablelist>
|
77
|
+
<varlistentry>
|
78
|
+
<term>メニューバー:</term>
|
79
|
+
|
80
|
+
<listitem>
|
81
|
+
<para>
|
82
|
+
メニューバー上のメニューは &app; でライブラリと本を管理するのに必要なすべてのコマンドが入っています。
|
83
|
+
</para>
|
84
|
+
</listitem>
|
85
|
+
</varlistentry>
|
86
|
+
<varlistentry>
|
87
|
+
<term>ツールバー:</term>
|
88
|
+
<listitem>
|
89
|
+
<para>
|
90
|
+
ツールバーには、&app; に新しい本やライブラリをすぐに追加するためのボタンがあります。
|
91
|
+
また、メイン画面の本を表示する場所にフィルターをかけて検索した結果を表示するためのツールもあります。
|
92
|
+
</para>
|
93
|
+
</listitem>
|
94
|
+
</varlistentry>
|
95
|
+
|
96
|
+
<varlistentry>
|
97
|
+
<term>ライブラリ一覧:</term>
|
98
|
+
|
99
|
+
<listitem>
|
100
|
+
<para>
|
101
|
+
ウィンドの左側にあるライブラリ一覧のペインには &app; で設定したライブラリを全て表示します。
|
102
|
+
メインライブラリの下は<quote>高機能ライブラリ</quote>で、
|
103
|
+
メインライブラリの中を指定した条件でフィルターした結果を表示します。
|
104
|
+
</para>
|
105
|
+
|
106
|
+
<para>
|
107
|
+
最初に &app; を起動したときに、<quote>マイライブラリ</quote>という名前のライブラリと、
|
108
|
+
いくつかの有用と思われる高機能ライブラリが作成されます。
|
109
|
+
</para>
|
110
|
+
|
111
|
+
</listitem>
|
112
|
+
</varlistentry>
|
113
|
+
|
114
|
+
<varlistentry>
|
115
|
+
<term>本の表示領域:</term>
|
116
|
+
|
117
|
+
<listitem>
|
118
|
+
<para>
|
119
|
+
メインの表示領域には、現在選択されているライブラリの中にあるすべての本が一覧表示されます。
|
120
|
+
<application>&app;</application> はアイコン表示または一覧表示ができます。
|
121
|
+
一覧表示は<application>Nautilus</application>ファイルマネージャーで使われているのと似た表示方法で、
|
122
|
+
1行ごとに本の詳細な情報を表示します。
|
123
|
+
</para>
|
124
|
+
|
125
|
+
<para>
|
126
|
+
アイコン表示では、あなたのお気に入りの本(5つ星がついた本)にはアイコンの右上にハート型のアイコンがつきます。
|
127
|
+
</para>
|
128
|
+
</listitem>
|
129
|
+
</varlistentry>
|
130
|
+
|
131
|
+
<varlistentry>
|
132
|
+
<term>ステータスバー:</term>
|
133
|
+
|
134
|
+
<listitem>
|
135
|
+
<para>
|
136
|
+
ステータスバーには、<application>&app;</application> の現在選択中のライブラリに関する情報
|
137
|
+
(本の数、評価の付けていていない本の数)が表示されます。
|
138
|
+
</para>
|
139
|
+
</listitem>
|
140
|
+
</varlistentry>
|
141
|
+
</variablelist>
|
142
|
+
|
143
|
+
</section>
|
144
|
+
</section>
|
@@ -0,0 +1,541 @@
|
|
1
|
+
<appendix id="gfdl">
|
2
|
+
<title>GNUフリー文書利用許諾契約書</title>
|
3
|
+
<subtitle>Version 1.2, November 2002</subtitle>
|
4
|
+
<para>
|
5
|
+
(訳注:日本語訳は<ulink url="http://www.opensource.jp/fdl/fdl.ja.html" type="http">
|
6
|
+
ここ</ulink>から読めます)</para>
|
7
|
+
<para>
|
8
|
+
|
9
|
+
Copyright © 2000, 2001, 2002 Free Software
|
10
|
+
Foundation, <abbrev>Inc.</abbrev>
|
11
|
+
<address>
|
12
|
+
<street>51 Franklin <abbrev>St</abbrev>, Fifth Floor</street>,
|
13
|
+
<city>Boston</city>,
|
14
|
+
<state><abbrev>MA</abbrev></state> <postcode>02111-1307</postcode>
|
15
|
+
<country><abbrev role="initialism">USA</abbrev></country>
|
16
|
+
</address>
|
17
|
+
|
18
|
+
Everyone is permitted to copy and distribute verbatim copies of
|
19
|
+
this license document, but changing it is not allowed.
|
20
|
+
</para>
|
21
|
+
|
22
|
+
<appendixinfo>
|
23
|
+
<title>GNU Free Documentation License</title>
|
24
|
+
<releaseinfo>
|
25
|
+
Version 1.2, November 2002
|
26
|
+
</releaseinfo>
|
27
|
+
|
28
|
+
<copyright>
|
29
|
+
<year>2000</year>
|
30
|
+
<year>2001</year>
|
31
|
+
<year>2002</year>
|
32
|
+
<holder>Free Software Foundation, <abbrev>Inc.</abbrev></holder>
|
33
|
+
</copyright>
|
34
|
+
|
35
|
+
<corpauthor>
|
36
|
+
<surname>Free Software Foundation</surname>
|
37
|
+
</corpauthor>
|
38
|
+
|
39
|
+
<legalnotice id="legalnotice">
|
40
|
+
<para>
|
41
|
+
Everyone is permitted to copy and distribute verbatim copies
|
42
|
+
of this license document, but changing it is not allowed.
|
43
|
+
</para>
|
44
|
+
</legalnotice>
|
45
|
+
|
46
|
+
</appendixinfo>
|
47
|
+
|
48
|
+
|
49
|
+
<section id="Preamble" label="0. ">
|
50
|
+
<title>PREAMBLE</title>
|
51
|
+
<para>
|
52
|
+
The purpose of this License is to make a manual, textbook, or other
|
53
|
+
functional and useful document "free" in the sense of freedom: to assure
|
54
|
+
everyone the effective freedom to copy and redistribute it, with or
|
55
|
+
without modifying it, either commercially or noncommercially.
|
56
|
+
Secondarily, this License preserves for the author and publisher a way to
|
57
|
+
get credit for their work, while not being considered responsible for
|
58
|
+
modifications made by others.
|
59
|
+
</para>
|
60
|
+
<para>
|
61
|
+
This License is a kind of "copyleft", which means that derivative works of
|
62
|
+
the document must themselves be free in the same sense. It complements
|
63
|
+
the GNU General Public License, which is a copyleft license designed for
|
64
|
+
free software.
|
65
|
+
</para>
|
66
|
+
<para>
|
67
|
+
We have designed this License in order to use it for manuals for free
|
68
|
+
software, because free software needs free documentation: a free program
|
69
|
+
should come with manuals providing the same freedoms that the software
|
70
|
+
does. But this License is not limited to software manuals; it can be used
|
71
|
+
for any textual work, regardless of subject matter or whether it is
|
72
|
+
published as a printed book. We recommend this License principally for
|
73
|
+
works whose purpose is instruction or reference.</para>
|
74
|
+
</section>
|
75
|
+
<section id="Definitions" label="1. ">
|
76
|
+
<title>APPLICABILITY AND DEFINITIONS</title>
|
77
|
+
<para>
|
78
|
+
This License applies to any manual or other work, in any medium, that
|
79
|
+
contains a notice placed by the copyright holder saying it can be
|
80
|
+
distributed under the terms of this License. Such a notice grants a
|
81
|
+
world-wide, royalty-free license, unlimited in duration, to use that work
|
82
|
+
under the conditions stated herein. The "Document", below, refers to any
|
83
|
+
such manual or work. Any member of the public is a licensee, and is
|
84
|
+
addressed as "you". You accept the license if you copy, modify or
|
85
|
+
distribute the work in a way requiring permission under copyright
|
86
|
+
law.
|
87
|
+
</para>
|
88
|
+
<para>
|
89
|
+
A "Modified Version" of the Document means any work containing the
|
90
|
+
Document or a portion of it, either copied verbatim, or with modifications
|
91
|
+
and/or translated into another language.
|
92
|
+
</para>
|
93
|
+
<para>
|
94
|
+
A "Secondary Section" is a named appendix or a front-matter section of the
|
95
|
+
Document that deals exclusively with the relationship of the publishers or
|
96
|
+
authors of the Document to the Document's overall subject (or to related
|
97
|
+
matters) and contains nothing that could fall directly within that overall
|
98
|
+
subject. (Thus, if the Document is in part a textbook of mathematics, a
|
99
|
+
Secondary Section may not explain any mathematics.) The relationship
|
100
|
+
could be a matter of historical connection with the subject or with
|
101
|
+
related matters, or of legal, commercial, philosophical, ethical or
|
102
|
+
political position regarding them.
|
103
|
+
</para>
|
104
|
+
<para>
|
105
|
+
The "Invariant Sections" are certain Secondary Sections whose titles are
|
106
|
+
designated, as being those of Invariant Sections, in the notice that says
|
107
|
+
that the Document is released under this License. If a section does not
|
108
|
+
fit the above definition of Secondary then it is not allowed to be
|
109
|
+
designated as Invariant. The Document may contain zero Invariant
|
110
|
+
Sections. If the Document does not identify any Invariant Sections then
|
111
|
+
there are none.
|
112
|
+
</para>
|
113
|
+
<para>
|
114
|
+
The "Cover Texts" are certain short passages of text that are listed, as
|
115
|
+
Front-Cover Texts or Back-Cover Texts, in the notice that says that the
|
116
|
+
Document is released under this License. A Front-Cover Text may be at
|
117
|
+
most 5 words, and a Back-Cover Text may be at most 25 words.
|
118
|
+
</para>
|
119
|
+
<para>
|
120
|
+
A "Transparent" copy of the Document means a machine-readable copy,
|
121
|
+
represented in a format whose specification is available to the general
|
122
|
+
public, that is suitable for revising the document straightforwardly with
|
123
|
+
generic text editors or (for images composed of pixels) generic paint
|
124
|
+
programs or (for drawings) some widely available drawing editor, and that
|
125
|
+
is suitable for input to text formatters or for automatic translation to a
|
126
|
+
variety of formats suitable for input to text formatters. A copy made in
|
127
|
+
an otherwise Transparent file format whose markup, or absence of markup,
|
128
|
+
has been arranged to thwart or discourage subsequent modification by
|
129
|
+
readers is not Transparent. An image format is not Transparent if used
|
130
|
+
for any substantial amount of text. A copy that is not "Transparent" is
|
131
|
+
called "Opaque".
|
132
|
+
</para>
|
133
|
+
<para>
|
134
|
+
Examples of suitable formats for Transparent copies include plain ASCII
|
135
|
+
without markup, Texinfo input format, LaTeX input format, SGML or XML
|
136
|
+
using a publicly available DTD, and standard-conforming simple HTML,
|
137
|
+
PostScript or PDF designed for human modification. Examples of
|
138
|
+
transparent image formats include PNG, XCF and JPG. Opaque formats
|
139
|
+
include proprietary formats that can be read and edited only by
|
140
|
+
proprietary word processors, SGML or XML for which the DTD and/or
|
141
|
+
processing tools are not generally available, and the machine-generated
|
142
|
+
HTML, PostScript or PDF produced by some word processors for output
|
143
|
+
purposes only.
|
144
|
+
</para>
|
145
|
+
<para>
|
146
|
+
The "Title Page" means, for a printed book, the title page itself, plus
|
147
|
+
such following pages as are needed to hold, legibly, the material this
|
148
|
+
License requires to appear in the title page. For works in formats which
|
149
|
+
do not have any title page as such, "Title Page" means the text near the
|
150
|
+
most prominent appearance of the work's title, preceding the beginning of
|
151
|
+
the body of the text.
|
152
|
+
</para>
|
153
|
+
<para>
|
154
|
+
A section "Entitled XYZ" means a named subunit of the Document whose title
|
155
|
+
either is precisely XYZ or contains XYZ in parentheses following text that
|
156
|
+
translates XYZ in another language. (Here XYZ stands for a specific
|
157
|
+
section name mentioned below, such as "Acknowledgements", "Dedications",
|
158
|
+
"Endorsements", or "History".) To "Preserve the Title" of such a section
|
159
|
+
when you modify the Document means that it remains a section "Entitled
|
160
|
+
XYZ" according to this definition.
|
161
|
+
</para>
|
162
|
+
<para>
|
163
|
+
The Document may include Warranty Disclaimers next to the notice which
|
164
|
+
states that this License applies to the Document. These Warranty
|
165
|
+
Disclaimers are considered to be included by reference in this License,
|
166
|
+
but only as regards disclaiming warranties: any other implication that
|
167
|
+
these Warranty Disclaimers may have is void and has no effect on the
|
168
|
+
meaning of this License.
|
169
|
+
</para>
|
170
|
+
</section>
|
171
|
+
<section id="VerbatimCopying" label="2. ">
|
172
|
+
<title>VERBATIM COPYING</title>
|
173
|
+
<para>
|
174
|
+
You may copy and distribute the Document in any medium, either
|
175
|
+
commercially or noncommercially, provided that this License, the copyright
|
176
|
+
notices, and the license notice saying this License applies to the
|
177
|
+
Document are reproduced in all copies, and that you add no other
|
178
|
+
conditions whatsoever to those of this License. You may not use technical
|
179
|
+
measures to obstruct or control the reading or further copying of the
|
180
|
+
copies you make or distribute. However, you may accept compensation in
|
181
|
+
exchange for copies. If you distribute a large enough number of copies
|
182
|
+
you must also follow the conditions in section 3.
|
183
|
+
</para>
|
184
|
+
<para>
|
185
|
+
You may also lend copies, under the same conditions stated above, and you
|
186
|
+
may publicly display copies.
|
187
|
+
</para>
|
188
|
+
</section>
|
189
|
+
<section id="QuantityCopying" label="3. ">
|
190
|
+
<title>COPYING IN QUANTITY</title>
|
191
|
+
<para>
|
192
|
+
If you publish printed copies (or copies in media that commonly have
|
193
|
+
printed covers) of the Document, numbering more than 100, and the
|
194
|
+
Document's license notice requires Cover Texts, you must enclose the
|
195
|
+
copies in covers that carry, clearly and legibly, all these Cover Texts:
|
196
|
+
Front-Cover Texts on the front cover, and Back-Cover Texts on the back
|
197
|
+
cover. Both covers must also clearly and legibly identify you as the
|
198
|
+
publisher of these copies. The front cover must present the full title
|
199
|
+
with all words of the title equally prominent and visible. You may add
|
200
|
+
other material on the covers in addition. Copying with changes limited to
|
201
|
+
the covers, as long as they preserve the title of the Document and satisfy
|
202
|
+
these conditions, can be treated as verbatim copying in other
|
203
|
+
respects.
|
204
|
+
</para>
|
205
|
+
<para>
|
206
|
+
If the required texts for either cover are too voluminous to fit legibly,
|
207
|
+
you should put the first ones listed (as many as fit reasonably) on the
|
208
|
+
actual cover, and continue the rest onto adjacent pages.
|
209
|
+
</para>
|
210
|
+
<para>
|
211
|
+
If you publish or distribute Opaque copies of the Document numbering more
|
212
|
+
than 100, you must either include a machine-readable Transparent copy
|
213
|
+
along with each Opaque copy, or state in or with each Opaque copy a
|
214
|
+
computer-network location from which the general network-using public has
|
215
|
+
access to download using public-standard network protocols a complete
|
216
|
+
Transparent copy of the Document, free of added material. If you use the
|
217
|
+
latter option, you must take reasonably prudent steps, when you begin
|
218
|
+
distribution of Opaque copies in quantity, to ensure that this Transparent
|
219
|
+
copy will remain thus accessible at the stated location until at least one
|
220
|
+
year after the last time you distribute an Opaque copy (directly or
|
221
|
+
through your agents or retailers) of that edition to the public.
|
222
|
+
</para>
|
223
|
+
<para>
|
224
|
+
It is requested, but not required, that you contact the authors of the
|
225
|
+
Document well before redistributing any large number of copies, to give
|
226
|
+
them a chance to provide you with an updated version of the
|
227
|
+
Document.
|
228
|
+
</para>
|
229
|
+
</section>
|
230
|
+
<section id="Modifications" label="4. ">
|
231
|
+
<title>MODIFICATIONS</title>
|
232
|
+
<para>
|
233
|
+
You may copy and distribute a Modified Version of the Document under the
|
234
|
+
conditions of sections 2 and 3 above, provided that you release the
|
235
|
+
Modified Version under precisely this License, with the Modified Version
|
236
|
+
filling the role of the Document, thus licensing distribution and
|
237
|
+
modification of the Modified Version to whoever possesses a copy of it.
|
238
|
+
In addition, you must do these things in the Modified Version:
|
239
|
+
</para>
|
240
|
+
<orderedlist numeration="upperalpha">
|
241
|
+
<listitem>
|
242
|
+
<simpara>
|
243
|
+
Use in the Title Page (and on the covers, if any) a title distinct
|
244
|
+
from that of the Document, and from those of previous versions (which
|
245
|
+
should, if there were any, be listed in the History section of the
|
246
|
+
Document). You may use the same title as a previous version if the
|
247
|
+
original publisher of that version gives permission.
|
248
|
+
</simpara>
|
249
|
+
</listitem>
|
250
|
+
<listitem>
|
251
|
+
<simpara>
|
252
|
+
List on the Title Page, as authors, one or more persons or entities
|
253
|
+
responsible for authorship of the modifications in the Modified
|
254
|
+
Version, together with at least five of the principal authors of the
|
255
|
+
Document (all of its principal authors, if it has fewer than five),
|
256
|
+
unless they release you from this requirement.
|
257
|
+
</simpara>
|
258
|
+
</listitem>
|
259
|
+
<listitem>
|
260
|
+
<simpara>
|
261
|
+
State on the Title page the name of the publisher of the Modified
|
262
|
+
Version, as the publisher.
|
263
|
+
</simpara>
|
264
|
+
</listitem>
|
265
|
+
<listitem>
|
266
|
+
<simpara>
|
267
|
+
Preserve all the copyright notices of the Document.
|
268
|
+
</simpara>
|
269
|
+
</listitem>
|
270
|
+
<listitem>
|
271
|
+
<simpara>
|
272
|
+
Add an appropriate copyright notice for your modifications adjacent to
|
273
|
+
the other copyright notices.
|
274
|
+
</simpara>
|
275
|
+
</listitem>
|
276
|
+
<listitem>
|
277
|
+
<simpara>
|
278
|
+
Include, immediately after the copyright notices, a license notice
|
279
|
+
giving the public permission to use the Modified Version under the
|
280
|
+
terms of this License, in the form shown in the Addendum below.
|
281
|
+
</simpara>
|
282
|
+
</listitem>
|
283
|
+
<listitem>
|
284
|
+
<simpara>
|
285
|
+
Preserve in that license notice the full lists of Invariant Sections
|
286
|
+
and required Cover Texts given in the Document's license notice.
|
287
|
+
</simpara>
|
288
|
+
</listitem>
|
289
|
+
<listitem>
|
290
|
+
<simpara>
|
291
|
+
Include an unaltered copy of this License.
|
292
|
+
</simpara>
|
293
|
+
</listitem>
|
294
|
+
<listitem>
|
295
|
+
<simpara>
|
296
|
+
Preserve the section Entitled "History", Preserve its Title, and add
|
297
|
+
to it an item stating at least the title, year, new authors, and
|
298
|
+
publisher of the Modified Version as given on the Title Page. If
|
299
|
+
there is no section Entitled "History" in the Document, create one
|
300
|
+
stating the title, year, authors, and publisher of the Document as
|
301
|
+
given on its Title Page, then add an item describing the Modified
|
302
|
+
Version as stated in the previous sentence.
|
303
|
+
</simpara>
|
304
|
+
</listitem>
|
305
|
+
<listitem>
|
306
|
+
<simpara>
|
307
|
+
Preserve the network location, if any, given in the Document for
|
308
|
+
public access to a Transparent copy of the Document, and likewise the
|
309
|
+
network locations given in the Document for previous versions it was
|
310
|
+
based on. These may be placed in the "History" section. You may omit
|
311
|
+
a network location for a work that was published at least four years
|
312
|
+
before the Document itself, or if the original publisher of the
|
313
|
+
version it refers to gives permission.
|
314
|
+
</simpara>
|
315
|
+
</listitem>
|
316
|
+
<listitem>
|
317
|
+
<simpara>
|
318
|
+
For any section Entitled "Acknowledgements" or "Dedications", Preserve
|
319
|
+
the Title of the section, and preserve in the section all the
|
320
|
+
substance and tone of each of the contributor acknowledgements and/or
|
321
|
+
dedications given therein.
|
322
|
+
</simpara>
|
323
|
+
</listitem>
|
324
|
+
<listitem>
|
325
|
+
<simpara>
|
326
|
+
Preserve all the Invariant Sections of the Document, unaltered in
|
327
|
+
their text and in their titles. Section numbers or the equivalent are
|
328
|
+
not considered part of the section titles.
|
329
|
+
</simpara>
|
330
|
+
</listitem>
|
331
|
+
<listitem>
|
332
|
+
<simpara>
|
333
|
+
Delete any section Entitled "Endorsements". Such a section may not be
|
334
|
+
included in the Modified Version.
|
335
|
+
</simpara>
|
336
|
+
</listitem>
|
337
|
+
<listitem>
|
338
|
+
<simpara>
|
339
|
+
Do not retitle any existing section to be Entitled "Endorsements" or
|
340
|
+
to conflict in title with any Invariant Section.
|
341
|
+
</simpara>
|
342
|
+
</listitem>
|
343
|
+
<listitem>
|
344
|
+
<simpara>
|
345
|
+
Preserve any Warranty Disclaimers.
|
346
|
+
</simpara>
|
347
|
+
</listitem>
|
348
|
+
</orderedlist>
|
349
|
+
<para>
|
350
|
+
If the Modified Version includes new front-matter sections or appendices
|
351
|
+
that qualify as Secondary Sections and contain no material copied from the
|
352
|
+
Document, you may at your option designate some or all of these sections
|
353
|
+
as invariant. To do this, add their titles to the list of Invariant
|
354
|
+
Sections in the Modified Version's license notice. These titles must be
|
355
|
+
distinct from any other section titles.
|
356
|
+
</para>
|
357
|
+
<para>
|
358
|
+
You may add a section Entitled "Endorsements", provided it contains
|
359
|
+
nothing but endorsements of your Modified Version by various parties--for
|
360
|
+
example, statements of peer review or that the text has been approved by
|
361
|
+
an organization as the authoritative definition of a standard.
|
362
|
+
</para>
|
363
|
+
<para>
|
364
|
+
You may add a passage of up to five words as a Front-Cover Text, and a
|
365
|
+
passage of up to 25 words as a Back-Cover Text, to the end of the list of
|
366
|
+
Cover Texts in the Modified Version. Only one passage of Front-Cover Text
|
367
|
+
and one of Back-Cover Text may be added by (or through arrangements made
|
368
|
+
by) any one entity. If the Document already includes a cover text for the
|
369
|
+
same cover, previously added by you or by arrangement made by the same
|
370
|
+
entity you are acting on behalf of, you may not add another; but you may
|
371
|
+
replace the old one, on explicit permission from the previous publisher
|
372
|
+
that added the old one.
|
373
|
+
</para>
|
374
|
+
<para>
|
375
|
+
The author(s) and publisher(s) of the Document do not by this License give
|
376
|
+
permission to use their names for publicity for or to assert or imply
|
377
|
+
endorsement of any Modified Version.
|
378
|
+
</para>
|
379
|
+
</section>
|
380
|
+
<section id="Combining" label="5. ">
|
381
|
+
<title>COMBINING DOCUMENTS</title>
|
382
|
+
<para>
|
383
|
+
You may combine the Document with other documents released under this
|
384
|
+
License, under the terms defined in section 4 above for modified versions,
|
385
|
+
provided that you include in the combination all of the Invariant Sections
|
386
|
+
of all of the original documents, unmodified, and list them all as
|
387
|
+
Invariant Sections of your combined work in its license notice, and that
|
388
|
+
you preserve all their Warranty Disclaimers.
|
389
|
+
</para>
|
390
|
+
<para>
|
391
|
+
The combined work need only contain one copy of this License, and multiple
|
392
|
+
identical Invariant Sections may be replaced with a single copy. If there
|
393
|
+
are multiple Invariant Sections with the same name but different contents,
|
394
|
+
make the title of each such section unique by adding at the end of it, in
|
395
|
+
parentheses, the name of the original author or publisher of that section
|
396
|
+
if known, or else a unique number. Make the same adjustment to the
|
397
|
+
section titles in the list of Invariant Sections in the license notice of
|
398
|
+
the combined work.
|
399
|
+
</para>
|
400
|
+
<para>
|
401
|
+
In the combination, you must combine any sections Entitled "History" in
|
402
|
+
the various original documents, forming one section Entitled "History";
|
403
|
+
likewise combine any sections Entitled "Acknowledgements", and any
|
404
|
+
sections Entitled "Dedications". You must delete all sections Entitled
|
405
|
+
"Endorsements".
|
406
|
+
</para>
|
407
|
+
</section>
|
408
|
+
<section id="Collections" label="6. ">
|
409
|
+
<title>COLLECTIONS OF DOCUMENTS</title>
|
410
|
+
<para>
|
411
|
+
You may make a collection consisting of the Document and other documents
|
412
|
+
released under this License, and replace the individual copies of this
|
413
|
+
License in the various documents with a single copy that is included in
|
414
|
+
the collection, provided that you follow the rules of this License for
|
415
|
+
verbatim copying of each of the documents in all other respects.
|
416
|
+
</para>
|
417
|
+
<para>
|
418
|
+
You may extract a single document from such a collection, and distribute
|
419
|
+
it individually under this License, provided you insert a copy of this
|
420
|
+
License into the extracted document, and follow this License in all other
|
421
|
+
respects regarding verbatim copying of that document.
|
422
|
+
</para>
|
423
|
+
</section>
|
424
|
+
<section id="Aggregation" label="7. ">
|
425
|
+
<title>AGGREGATION WITH INDEPENDENT WORKS</title>
|
426
|
+
<para>
|
427
|
+
A compilation of the Document or its derivatives with other separate and
|
428
|
+
independent documents or works, in or on a volume of a storage or
|
429
|
+
distribution medium, is called an "aggregate" if the copyright resulting
|
430
|
+
from the compilation is not used to limit the legal rights of the
|
431
|
+
compilation's users beyond what the individual works permit. When the
|
432
|
+
Document is included in an aggregate, this License does not apply to the
|
433
|
+
other works in the aggregate which are not themselves derivative works of
|
434
|
+
the Document.
|
435
|
+
</para>
|
436
|
+
<para>
|
437
|
+
If the Cover Text requirement of section 3 is applicable to these copies
|
438
|
+
of the Document, then if the Document is less than one half of the entire
|
439
|
+
aggregate, the Document's Cover Texts may be placed on covers that bracket
|
440
|
+
the Document within the aggregate, or the electronic equivalent of covers
|
441
|
+
if the Document is in electronic form. Otherwise they must appear on
|
442
|
+
printed covers that bracket the whole aggregate.
|
443
|
+
</para>
|
444
|
+
</section>
|
445
|
+
<section id="Translation" label="8. ">
|
446
|
+
<title>TRANSLATION</title>
|
447
|
+
<para>
|
448
|
+
Translation is considered a kind of modification, so you may distribute
|
449
|
+
translations of the Document under the terms of section 4. Replacing
|
450
|
+
Invariant Sections with translations requires special permission from
|
451
|
+
their copyright holders, but you may include translations of some or all
|
452
|
+
Invariant Sections in addition to the original versions of these Invariant
|
453
|
+
Sections. You may include a translation of this License, and all the
|
454
|
+
license notices in the Document, and any Warranty Disclaimers, provided
|
455
|
+
that you also include the original English version of this License and the
|
456
|
+
original versions of those notices and disclaimers. In case of a
|
457
|
+
disagreement between the translation and the original version of this
|
458
|
+
License or a notice or disclaimer, the original version will prevail.
|
459
|
+
</para>
|
460
|
+
<para>
|
461
|
+
If a section in the Document is Entitled "Acknowledgements",
|
462
|
+
"Dedications", or "History", the requirement (section 4) to Preserve its
|
463
|
+
Title (section 1) will typically require changing the actual title.
|
464
|
+
</para>
|
465
|
+
</section>
|
466
|
+
<section id="Termination" label="9. ">
|
467
|
+
<title>TERMINATION</title>
|
468
|
+
<para>
|
469
|
+
You may not copy, modify, sublicense, or distribute the Document except as
|
470
|
+
expressly provided for under this License. Any other attempt to copy,
|
471
|
+
modify, sublicense or distribute the Document is void, and will
|
472
|
+
automatically terminate your rights under this License. However, parties
|
473
|
+
who have received copies, or rights, from you under this License will not
|
474
|
+
have their licenses terminated so long as such parties remain in full
|
475
|
+
compliance.
|
476
|
+
</para>
|
477
|
+
</section>
|
478
|
+
<section id="FutureRevisions" label="10. ">
|
479
|
+
<title>FUTURE REVISIONS OF THIS LICENSE</title>
|
480
|
+
<para>
|
481
|
+
The Free Software Foundation may publish new, revised versions of the GNU
|
482
|
+
Free Documentation License from time to time. Such new versions will be
|
483
|
+
similar in spirit to the present version, but may differ in detail to
|
484
|
+
address new problems or concerns. See <ulink
|
485
|
+
url="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</ulink>.
|
486
|
+
</para>
|
487
|
+
<para>
|
488
|
+
Each version of the License is given a distinguishing version number. If
|
489
|
+
the Document specifies that a particular numbered version of this License
|
490
|
+
"or any later version" applies to it, you have the option of following the
|
491
|
+
terms and conditions either of that specified version or of any later
|
492
|
+
version that has been published (not as a draft) by the Free Software
|
493
|
+
Foundation. If the Document does not specify a version number of this
|
494
|
+
License, you may choose any version ever published (not as a draft) by the
|
495
|
+
Free Software Foundation.
|
496
|
+
</para>
|
497
|
+
</section>
|
498
|
+
<section id="HowToUse" label="ADDENDUM: ">
|
499
|
+
<title>How to use this License for your documents</title>
|
500
|
+
|
501
|
+
<para>
|
502
|
+
To use this License in a document you have written, include a copy of the
|
503
|
+
License in the document and put the following copyright and license
|
504
|
+
notices just after the title page:
|
505
|
+
</para>
|
506
|
+
<blockquote>
|
507
|
+
<para>
|
508
|
+
Copyright © YEAR YOUR NAME.
|
509
|
+
</para>
|
510
|
+
<para>
|
511
|
+
Permission is granted to copy, distribute and/or modify this document
|
512
|
+
under the terms of the GNU Free Documentation License, Version 1.2 or
|
513
|
+
any later version published by the Free Software Foundation; with no
|
514
|
+
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
|
515
|
+
copy of the license is included in the section entitled "GNU Free
|
516
|
+
Documentation License".
|
517
|
+
</para>
|
518
|
+
</blockquote>
|
519
|
+
<para>
|
520
|
+
If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
|
521
|
+
replace the "with...Texts." line with this:
|
522
|
+
</para>
|
523
|
+
<blockquote>
|
524
|
+
<para>
|
525
|
+
with the Invariant Sections being LIST THEIR TITLES, with the
|
526
|
+
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
|
527
|
+
</para>
|
528
|
+
</blockquote>
|
529
|
+
<para>
|
530
|
+
If you have Invariant Sections without Cover Texts, or some other
|
531
|
+
combination of the three, merge those two alternatives to suit the
|
532
|
+
situation.
|
533
|
+
</para>
|
534
|
+
<para>
|
535
|
+
If your document contains nontrivial examples of program code, we
|
536
|
+
recommend releasing these examples in parallel under your choice of free
|
537
|
+
software license, such as the GNU General Public License, to permit their
|
538
|
+
use in free software.
|
539
|
+
</para>
|
540
|
+
</section>
|
541
|
+
</appendix>
|