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.
Files changed (293) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +10 -0
  3. data/.rubocop.yml +68 -0
  4. data/.rubocop_todo.yml +200 -0
  5. data/CHANGELOG.md +23 -0
  6. data/COPYING +339 -0
  7. data/ChangeLog.0 +3598 -0
  8. data/Gemfile +9 -0
  9. data/INSTALL.rdoc +156 -0
  10. data/PACKAGING +36 -0
  11. data/README.md +88 -0
  12. data/RELEASE_CHECKLIST +18 -0
  13. data/Rakefile +264 -0
  14. data/TODO +24 -0
  15. data/alexandria-book-collection-manager.gemspec +35 -0
  16. data/alexandria.desktop.in +10 -0
  17. data/bin/alexandria +82 -0
  18. data/doc/AUTHORS +60 -0
  19. data/doc/BUGS +31 -0
  20. data/doc/FAQ +369 -0
  21. data/doc/HACKING +19 -0
  22. data/doc/NEWS +341 -0
  23. data/doc/alexandria.1 +120 -0
  24. data/doc/cuecat_support.rdoc +67 -0
  25. data/lib/alexandria.rb +85 -0
  26. data/lib/alexandria/about.rb +82 -0
  27. data/lib/alexandria/book_providers.rb +411 -0
  28. data/lib/alexandria/book_providers/adlibris.rb +235 -0
  29. data/lib/alexandria/book_providers/amazon_aws.rb +261 -0
  30. data/lib/alexandria/book_providers/amazon_ecs_util.rb +405 -0
  31. data/lib/alexandria/book_providers/barnes_and_noble.rb +229 -0
  32. data/lib/alexandria/book_providers/bol_it.rb +162 -0
  33. data/lib/alexandria/book_providers/deastore.rb +277 -0
  34. data/lib/alexandria/book_providers/douban.rb +135 -0
  35. data/lib/alexandria/book_providers/ibs_it.rb +149 -0
  36. data/lib/alexandria/book_providers/mcu.rb +177 -0
  37. data/lib/alexandria/book_providers/proxis.rb +205 -0
  38. data/lib/alexandria/book_providers/pseudomarc.rb +185 -0
  39. data/lib/alexandria/book_providers/renaud.rb +142 -0
  40. data/lib/alexandria/book_providers/siciliano.rb +271 -0
  41. data/lib/alexandria/book_providers/thalia.rb +197 -0
  42. data/lib/alexandria/book_providers/web.rb +59 -0
  43. data/lib/alexandria/book_providers/webster_it.rb +173 -0
  44. data/lib/alexandria/book_providers/worldcat.rb +251 -0
  45. data/lib/alexandria/book_providers/z3950.rb +422 -0
  46. data/lib/alexandria/config.rb +8 -0
  47. data/lib/alexandria/console.rb +31 -0
  48. data/lib/alexandria/execution_queue.rb +96 -0
  49. data/lib/alexandria/export_library.rb +536 -0
  50. data/lib/alexandria/import_library.rb +316 -0
  51. data/lib/alexandria/import_library_csv.rb +270 -0
  52. data/lib/alexandria/logging.rb +159 -0
  53. data/lib/alexandria/models/book.rb +72 -0
  54. data/lib/alexandria/models/library.rb +714 -0
  55. data/lib/alexandria/net.rb +53 -0
  56. data/lib/alexandria/preferences.rb +324 -0
  57. data/lib/alexandria/scanners.rb +42 -0
  58. data/lib/alexandria/scanners/cuecat.rb +118 -0
  59. data/lib/alexandria/scanners/keyboard.rb +57 -0
  60. data/lib/alexandria/smart_library.rb +525 -0
  61. data/lib/alexandria/ui.rb +53 -0
  62. data/lib/alexandria/ui/builder_base.rb +43 -0
  63. data/lib/alexandria/ui/callbacks.rb +389 -0
  64. data/lib/alexandria/ui/completion_models.rb +228 -0
  65. data/lib/alexandria/ui/dialogs/about_dialog.rb +59 -0
  66. data/lib/alexandria/ui/dialogs/acquire_dialog.rb +640 -0
  67. data/lib/alexandria/ui/dialogs/alert_dialog.rb +68 -0
  68. data/lib/alexandria/ui/dialogs/bad_isbns_dialog.rb +43 -0
  69. data/lib/alexandria/ui/dialogs/barcode_animation.rb +159 -0
  70. data/lib/alexandria/ui/dialogs/book_properties_dialog.rb +210 -0
  71. data/lib/alexandria/ui/dialogs/book_properties_dialog_base.rb +432 -0
  72. data/lib/alexandria/ui/dialogs/export_dialog.rb +172 -0
  73. data/lib/alexandria/ui/dialogs/import_dialog.rb +205 -0
  74. data/lib/alexandria/ui/dialogs/misc_dialogs.rb +85 -0
  75. data/lib/alexandria/ui/dialogs/new_book_dialog.rb +639 -0
  76. data/lib/alexandria/ui/dialogs/new_book_dialog_manual.rb +153 -0
  77. data/lib/alexandria/ui/dialogs/new_smart_library_dialog.rb +67 -0
  78. data/lib/alexandria/ui/dialogs/preferences_dialog.rb +587 -0
  79. data/lib/alexandria/ui/dialogs/smart_library_properties_dialog.rb +56 -0
  80. data/lib/alexandria/ui/dialogs/smart_library_properties_dialog_base.rb +432 -0
  81. data/lib/alexandria/ui/dndable.rb +81 -0
  82. data/lib/alexandria/ui/gtk_thread_help.rb +88 -0
  83. data/lib/alexandria/ui/icons.rb +100 -0
  84. data/lib/alexandria/ui/iconview.rb +91 -0
  85. data/lib/alexandria/ui/iconview_tooltips.rb +162 -0
  86. data/lib/alexandria/ui/init.rb +93 -0
  87. data/lib/alexandria/ui/libraries_combo.rb +75 -0
  88. data/lib/alexandria/ui/listview.rb +310 -0
  89. data/lib/alexandria/ui/main_app.rb +67 -0
  90. data/lib/alexandria/ui/multi_drag_treeview.rb +150 -0
  91. data/lib/alexandria/ui/sidepane.rb +194 -0
  92. data/lib/alexandria/ui/sound.rb +107 -0
  93. data/lib/alexandria/ui/ui_manager.rb +1308 -0
  94. data/lib/alexandria/undo_manager.rb +78 -0
  95. data/lib/alexandria/utils.rb +30 -0
  96. data/lib/alexandria/version.rb +24 -0
  97. data/lib/alexandria/web_themes.rb +75 -0
  98. data/misc/sounds/README +15 -0
  99. data/misc/sounds/bad_scan.csd +62 -0
  100. data/misc/sounds/good_scan.csd +61 -0
  101. data/misc/sounds/scanning.csd +46 -0
  102. data/po/ChangeLog +488 -0
  103. data/po/Makefile +44 -0
  104. data/po/README +29 -0
  105. data/po/commit-po +72 -0
  106. data/po/cs.po +1437 -0
  107. data/po/cy.po +1521 -0
  108. data/po/de.po +1400 -0
  109. data/po/el.po +1379 -0
  110. data/po/es.po +1376 -0
  111. data/po/fr.po +1420 -0
  112. data/po/ga.po +1359 -0
  113. data/po/gl.po +1397 -0
  114. data/po/it.po +1406 -0
  115. data/po/ja.po +1355 -0
  116. data/po/mk.po +1373 -0
  117. data/po/nb.po +1386 -0
  118. data/po/nl.po +1405 -0
  119. data/po/pl.po +1373 -0
  120. data/po/pt.po +1398 -0
  121. data/po/pt_BR.po +1409 -0
  122. data/po/ru.po +1372 -0
  123. data/po/sk.po +1380 -0
  124. data/po/sv.po +1402 -0
  125. data/po/uk.po +1423 -0
  126. data/po/zh_TW.po +1394 -0
  127. data/schemas/alexandria.schemas +300 -0
  128. data/share/alexandria/glade/acquire_dialog__builder.glade +201 -0
  129. data/share/alexandria/glade/book_properties_dialog__builder.glade +910 -0
  130. data/share/alexandria/glade/main_app__builder.glade +229 -0
  131. data/share/alexandria/glade/new_book_dialog__builder.glade +379 -0
  132. data/share/alexandria/glade/preferences_dialog__builder.glade +733 -0
  133. data/share/alexandria/icons/alexandria.png +0 -0
  134. data/share/alexandria/icons/alexandria_small.png +0 -0
  135. data/share/alexandria/icons/book.png +0 -0
  136. data/share/alexandria/icons/book_icon.png +0 -0
  137. data/share/alexandria/icons/book_small.png +0 -0
  138. data/share/alexandria/icons/cuecat.png +0 -0
  139. data/share/alexandria/icons/cuecat_inactive.png +0 -0
  140. data/share/alexandria/icons/favorite_tag.png +0 -0
  141. data/share/alexandria/icons/less.png +0 -0
  142. data/share/alexandria/icons/library.png +0 -0
  143. data/share/alexandria/icons/library_small.png +0 -0
  144. data/share/alexandria/icons/lookup.png +0 -0
  145. data/share/alexandria/icons/more.png +0 -0
  146. data/share/alexandria/icons/no_cover.png +0 -0
  147. data/share/alexandria/icons/smart_library.png +0 -0
  148. data/share/alexandria/icons/smart_library_small.png +0 -0
  149. data/share/alexandria/icons/star_set.png +0 -0
  150. data/share/alexandria/icons/star_unset.png +0 -0
  151. data/share/alexandria/icons/view_as_icons.png +0 -0
  152. data/share/alexandria/icons/view_as_list.png +0 -0
  153. data/share/alexandria/ui/menus.xml +91 -0
  154. data/share/alexandria/ui/popups.xml +91 -0
  155. data/share/alexandria/web-themes/clean/clean.css +85 -0
  156. data/share/alexandria/web-themes/clean/preview.jpg +0 -0
  157. data/share/alexandria/web-themes/list/list.css +105 -0
  158. data/share/alexandria/web-themes/list/preview.jpg +0 -0
  159. data/share/app-icon/16x16/alexandria.png +0 -0
  160. data/share/app-icon/16x16/alexandria.svg +263 -0
  161. data/share/app-icon/22x22/alexandria.png +0 -0
  162. data/share/app-icon/22x22/alexandria.svg +465 -0
  163. data/share/app-icon/24x24/alexandria.png +0 -0
  164. data/share/app-icon/32x32/alexandria.png +0 -0
  165. data/share/app-icon/32x32/alexandria.svg +813 -0
  166. data/share/app-icon/32x32/alexandria.xpm +241 -0
  167. data/share/app-icon/48x48/alexandria.png +0 -0
  168. data/share/app-icon/scalable/alexandria.svg +700 -0
  169. data/share/gnome/help/alexandria/C/about.xml +44 -0
  170. data/share/gnome/help/alexandria/C/adding-books.xml +339 -0
  171. data/share/gnome/help/alexandria/C/alexandria.xml +185 -0
  172. data/share/gnome/help/alexandria/C/bugs.xml +18 -0
  173. data/share/gnome/help/alexandria/C/editing-book-properties.xml +124 -0
  174. data/share/gnome/help/alexandria/C/exporting.xml +81 -0
  175. data/share/gnome/help/alexandria/C/figures/adding_books_acquire_from_scanner_process.png +0 -0
  176. data/share/gnome/help/alexandria/C/figures/adding_books_add_by_isbn.png +0 -0
  177. data/share/gnome/help/alexandria/C/figures/adding_books_isbn_import.png +0 -0
  178. data/share/gnome/help/alexandria/C/figures/adding_books_manual_details.png +0 -0
  179. data/share/gnome/help/alexandria/C/figures/adding_books_rename_library_after_import.png +0 -0
  180. data/share/gnome/help/alexandria/C/figures/adding_books_search_results.png +0 -0
  181. data/share/gnome/help/alexandria/C/figures/editing_book_properties_info.png +0 -0
  182. data/share/gnome/help/alexandria/C/figures/editing_book_properties_loaning.png +0 -0
  183. data/share/gnome/help/alexandria/C/figures/exporting_information_html.png +0 -0
  184. data/share/gnome/help/alexandria/C/figures/getting_started_first_launched.png +0 -0
  185. data/share/gnome/help/alexandria/C/figures/searching_filtering_views_list_view.png +0 -0
  186. data/share/gnome/help/alexandria/C/figures/searching_filtering_views_list_view_search.png +0 -0
  187. data/share/gnome/help/alexandria/C/figures/settings_providers_new_z3950.png +0 -0
  188. data/share/gnome/help/alexandria/C/figures/smart_libraries_new_smart_library.png +0 -0
  189. data/share/gnome/help/alexandria/C/figures/working_with_libraries_library_pane.png +0 -0
  190. data/share/gnome/help/alexandria/C/getting-started.xml +154 -0
  191. data/share/gnome/help/alexandria/C/gnu-fdl-1.2.xml +543 -0
  192. data/share/gnome/help/alexandria/C/introduction.xml +142 -0
  193. data/share/gnome/help/alexandria/C/searching.xml +90 -0
  194. data/share/gnome/help/alexandria/C/settings.xml +140 -0
  195. data/share/gnome/help/alexandria/C/smart-libraries.xml +160 -0
  196. data/share/gnome/help/alexandria/C/working-with-libraries.xml +76 -0
  197. data/share/gnome/help/alexandria/ChangeLog +99 -0
  198. data/share/gnome/help/alexandria/fr/alexandria.xml +2292 -0
  199. data/share/gnome/help/alexandria/fr/figures/alexandria_add_button.png +0 -0
  200. data/share/gnome/help/alexandria/fr/figures/alexandria_add_by_isbn_1.png +0 -0
  201. data/share/gnome/help/alexandria/fr/figures/alexandria_add_by_search_1.png +0 -0
  202. data/share/gnome/help/alexandria/fr/figures/alexandria_add_manually.png +0 -0
  203. data/share/gnome/help/alexandria/fr/figures/alexandria_add_z3950.png +0 -0
  204. data/share/gnome/help/alexandria/fr/figures/alexandria_close_button.png +0 -0
  205. data/share/gnome/help/alexandria/fr/figures/alexandria_edit_info.png +0 -0
  206. data/share/gnome/help/alexandria/fr/figures/alexandria_export_web_page.png +0 -0
  207. data/share/gnome/help/alexandria/fr/figures/alexandria_importing.png +0 -0
  208. data/share/gnome/help/alexandria/fr/figures/alexandria_library_pane.png +0 -0
  209. data/share/gnome/help/alexandria/fr/figures/alexandria_list_view.png +0 -0
  210. data/share/gnome/help/alexandria/fr/figures/alexandria_list_view_search.png +0 -0
  211. data/share/gnome/help/alexandria/fr/figures/alexandria_loaning.png +0 -0
  212. data/share/gnome/help/alexandria/fr/figures/alexandria_main_window.png +0 -0
  213. data/share/gnome/help/alexandria/fr/figures/alexandria_remove_button.png +0 -0
  214. data/share/gnome/help/alexandria/ja/about.xml +33 -0
  215. data/share/gnome/help/alexandria/ja/adding-books.xml +314 -0
  216. data/share/gnome/help/alexandria/ja/alexandria.xml +172 -0
  217. data/share/gnome/help/alexandria/ja/bugs.xml +11 -0
  218. data/share/gnome/help/alexandria/ja/editing-book-properties.xml +100 -0
  219. data/share/gnome/help/alexandria/ja/exporting.xml +98 -0
  220. data/share/gnome/help/alexandria/ja/figures/adding_books_acquire_from_scanner_process.png +0 -0
  221. data/share/gnome/help/alexandria/ja/figures/adding_books_add_by_isbn.png +0 -0
  222. data/share/gnome/help/alexandria/ja/figures/adding_books_isbn_import.png +0 -0
  223. data/share/gnome/help/alexandria/ja/figures/adding_books_manual_details.png +0 -0
  224. data/share/gnome/help/alexandria/ja/figures/adding_books_rename_library_after_import.png +0 -0
  225. data/share/gnome/help/alexandria/ja/figures/adding_books_search_results.png +0 -0
  226. data/share/gnome/help/alexandria/ja/figures/editing_book_properties_info.png +0 -0
  227. data/share/gnome/help/alexandria/ja/figures/editing_book_properties_loaning.png +0 -0
  228. data/share/gnome/help/alexandria/ja/figures/exporting_information_html.png +0 -0
  229. data/share/gnome/help/alexandria/ja/figures/getting_started_first_launched.png +0 -0
  230. data/share/gnome/help/alexandria/ja/figures/searching_filtering_views_list_view.png +0 -0
  231. data/share/gnome/help/alexandria/ja/figures/searching_filtering_views_list_view_search.png +0 -0
  232. data/share/gnome/help/alexandria/ja/figures/settings_providers_new_z3950.png +0 -0
  233. data/share/gnome/help/alexandria/ja/figures/smart_libraries_new_smart_library.png +0 -0
  234. data/share/gnome/help/alexandria/ja/figures/working_with_libraries_library_pane.png +0 -0
  235. data/share/gnome/help/alexandria/ja/getting-started.xml +144 -0
  236. data/share/gnome/help/alexandria/ja/gnu-fdl-1.2.xml +541 -0
  237. data/share/gnome/help/alexandria/ja/introduction.xml +134 -0
  238. data/share/gnome/help/alexandria/ja/searching.xml +104 -0
  239. data/share/gnome/help/alexandria/ja/settings.xml +129 -0
  240. data/share/gnome/help/alexandria/ja/smart-libraries.xml +140 -0
  241. data/share/gnome/help/alexandria/ja/working-with-libraries.xml +88 -0
  242. data/share/menu/alexandria +7 -0
  243. data/share/omf/alexandria/alexandria-C.omf.in +27 -0
  244. data/share/omf/alexandria/alexandria-fr.omf.in +30 -0
  245. data/share/sounds/alexandria/bad_scan.ogg +0 -0
  246. data/share/sounds/alexandria/bad_scan.wav +0 -0
  247. data/share/sounds/alexandria/good_scan.ogg +0 -0
  248. data/share/sounds/alexandria/good_scan.wav +0 -0
  249. data/share/sounds/alexandria/scanning.ogg +0 -0
  250. data/share/sounds/alexandria/scanning.wav +0 -0
  251. data/spec/alexandria/library_spec.rb +205 -0
  252. data/spec/alexandria/preferences_spec.rb +22 -0
  253. data/spec/alexandria/scanners/cuecat_spec.rb +68 -0
  254. data/spec/alexandria/smart_library_spec.rb +22 -0
  255. data/spec/alexandria/ui/dialogs_spec.rb +90 -0
  256. data/spec/alexandria/ui/iconview_spec.rb +27 -0
  257. data/spec/alexandria/ui/listview_spec.rb +28 -0
  258. data/spec/alexandria/ui/main_app_spec.rb +48 -0
  259. data/spec/alexandria/ui/sidepane_spec.rb +27 -0
  260. data/spec/alexandria/ui/ui_manager_spec.rb +26 -0
  261. data/spec/alexandria/ui/ui_utilities_spec.rb +60 -0
  262. data/spec/alexandria/utilities_spec.rb +50 -0
  263. data/spec/data/libraries/0.6.1-noisbn/My Library/0201398257.yaml +10 -0
  264. data/spec/data/libraries/0.6.1-noisbn/My Library/1565920007.yaml +10 -0
  265. data/spec/data/libraries/0.6.1/My Library/0192812173.yaml +9 -0
  266. data/spec/data/libraries/0.6.1/My Library/0201398257.cover +0 -0
  267. data/spec/data/libraries/0.6.1/My Library/0201398257.yaml +10 -0
  268. data/spec/data/libraries/0.6.1/My Library/1565920007.yaml +10 -0
  269. data/spec/data/libraries/0.6.2/My Library/9780140266146.cover +0 -0
  270. data/spec/data/libraries/0.6.2/My Library/9780140266146.yaml +16 -0
  271. data/spec/data/libraries/0.6.2/My Library/9780140278781.cover +0 -0
  272. data/spec/data/libraries/0.6.2/My Library/9780140278781.yaml +21 -0
  273. data/spec/data/libraries/0.6.2/My Library/9780571147168.cover +0 -0
  274. data/spec/data/libraries/0.6.2/My Library/9780571147168.yaml +20 -0
  275. data/spec/data/libraries/0.6.2/My Library/9780575079038.cover +0 -0
  276. data/spec/data/libraries/0.6.2/My Library/9780575079038.yaml +20 -0
  277. data/spec/data/libraries/0.6.2/My Library/9780755322800.cover +0 -0
  278. data/spec/data/libraries/0.6.2/My Library/9780755322800.yaml +20 -0
  279. data/spec/spec_helper.rb +46 -0
  280. data/tasks/rdoc.rake +6 -0
  281. data/tasks/setup.rb +30 -0
  282. data/tasks/spec.rake +29 -0
  283. data/tasks/test.rake +38 -0
  284. data/test/application_test.rb +39 -0
  285. data/test/book_test.rb +34 -0
  286. data/test/data/isbns.txt +3 -0
  287. data/test/isbn_test.rb +68 -0
  288. data/test/providers_test.rb +254 -0
  289. data/test/test_helper.rb +42 -0
  290. data/util/rake/fileinstall.rb +313 -0
  291. data/util/rake/gettextgenerate.rb +158 -0
  292. data/util/rake/omfgenerate.rb +79 -0
  293. 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>
@@ -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 &copy; 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 &copy; 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>