diff options
| author | Slávek Banko <[email protected]> | 2022-12-13 00:23:00 +0100 |
|---|---|---|
| committer | Slávek Banko <[email protected]> | 2022-12-13 00:44:38 +0100 |
| commit | b02fdb4d705016a6c8e83f9d492b8df7c531b805 (patch) | |
| tree | 766b40d911fbf23ef6c9ea8f41b4e523c7cf9503 /doc/en | |
| parent | facdbc2fcef5f9bfbd56c1eef53e61eb8e7438a1 (diff) | |
| download | bibletime-b02fdb4d705016a6c8e83f9d492b8df7c531b805.tar.gz bibletime-b02fdb4d705016a6c8e83f9d492b8df7c531b805.zip | |
Conversion to CMake build system.
Remove the generated files from the source tree.
Copy translations to a new directory layout.
Added translation of .desktop files.
Signed-off-by: Slávek Banko <[email protected]>
Diffstat (limited to 'doc/en')
66 files changed, 2283 insertions, 0 deletions
diff --git a/doc/en/CMakeL10n.txt b/doc/en/CMakeL10n.txt new file mode 100644 index 0000000..b585ce4 --- /dev/null +++ b/doc/en/CMakeL10n.txt @@ -0,0 +1,3 @@ +##### create translation templates ############## + +tde_l10n_auto_add_subdirectories( ) diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt new file mode 100644 index 0000000..a03830a --- /dev/null +++ b/doc/en/CMakeLists.txt @@ -0,0 +1,3 @@ + +add_subdirectory( handbook ) +tde_conditional_add_subdirectory( WITH_HOWTO_DOC howto ) diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 0000000..b7a1e64 --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1 @@ +SUBDIRS = handbook $(HOWTODIR) diff --git a/doc/en/handbook/CMakeL10n.txt b/doc/en/handbook/CMakeL10n.txt new file mode 100644 index 0000000..b585ce4 --- /dev/null +++ b/doc/en/handbook/CMakeL10n.txt @@ -0,0 +1,3 @@ +##### create translation templates ############## + +tde_l10n_auto_add_subdirectories( ) diff --git a/doc/en/handbook/CMakeLists.txt b/doc/en/handbook/CMakeLists.txt new file mode 100644 index 0000000..5b45dc8 --- /dev/null +++ b/doc/en/handbook/CMakeLists.txt @@ -0,0 +1,3 @@ + +add_subdirectory( unicode ) +add_subdirectory( html ) diff --git a/doc/en/handbook/Makefile.am b/doc/en/handbook/Makefile.am new file mode 100644 index 0000000..c4da710 --- /dev/null +++ b/doc/en/handbook/Makefile.am @@ -0,0 +1,17 @@ +# this Makefile.am was automatically generated by bibletime/maintenance/gen_am.sh +# please do not edit this file but rather run the script to update + + +SUBDIRS = unicode html + + +html-files: + if test -e unicode/index.docbook; then \ + olddir=$$PWD; \ + cd html;\ + echo "Validating the XML files..."; \ + if meinproc ../unicode/index.docbook; then\ + echo "HTML files created successfully."; \ + fi; cd $$olddir; \ + fi; + diff --git a/doc/en/handbook/html/CMakeLists.txt b/doc/en/handbook/html/CMakeLists.txt new file mode 100644 index 0000000..f213264 --- /dev/null +++ b/doc/en/handbook/html/CMakeLists.txt @@ -0,0 +1,7 @@ + +file( GLOB handbook_images *.png ) + +install( + FILES ${handbook_images} + DESTINATION ${HTML_INSTALL_DIR}/en/${PROJECT_NAME}/handbook +) diff --git a/doc/en/handbook/html/Makefile.am b/doc/en/handbook/html/Makefile.am new file mode 100644 index 0000000..bb1a3ce --- /dev/null +++ b/doc/en/handbook/html/Makefile.am @@ -0,0 +1,127 @@ +# this Makefile.am was automatically generated by bibletime/maintenance/gen_am.sh +# please do not edit this file but rather run the script to update + + +KDE_OPTIONS = noautodist +EXTRA_DIST = i_bible_add.png i_bible.png i_bibletime.png i_book_add.png i_book.png i_cascade_auto.png i_cascade.png i_commentary_add.png i_commentary.png i_configureaccels.png i_configuredisplay.png i_configurefonts.png i_configure.png i_configurestart.png i_configuresword.png i_configuretoolbars.png i_contents.png i_delete.png i_editdelete.png i_exit.png i_fileclose.png i_fileprint.png i_find.png i_fullscreen.png i_go.png i_ktip.png i_lexicon_add.png i_lexicon.png i_pencil.png i_sidetree.png i_sync.png i_tile_auto.png i_tile.png ss_configfonts.png ss_configtoolbar.png ss_mainterms.png ss_searchanal.png ss_searchopts.png + + +install-data-local: + mkdir -p $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/; + chmod -R a+r+X $(DESTDIR)$(kde_htmldir)/en/bibletime; + $(INSTALL_DATA) $(srcdir)/i_bible_add.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_bible_add.png; + $(INSTALL_DATA) $(srcdir)/i_bible.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_bible.png; + $(INSTALL_DATA) $(srcdir)/i_bibletime.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_bibletime.png; + $(INSTALL_DATA) $(srcdir)/i_book_add.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_book_add.png; + $(INSTALL_DATA) $(srcdir)/i_book.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_book.png; + $(INSTALL_DATA) $(srcdir)/i_cascade_auto.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_cascade_auto.png; + $(INSTALL_DATA) $(srcdir)/i_cascade.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_cascade.png; + $(INSTALL_DATA) $(srcdir)/i_commentary_add.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_commentary_add.png; + $(INSTALL_DATA) $(srcdir)/i_commentary.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_commentary.png; + $(INSTALL_DATA) $(srcdir)/i_configureaccels.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configureaccels.png; + $(INSTALL_DATA) $(srcdir)/i_configuredisplay.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configuredisplay.png; + $(INSTALL_DATA) $(srcdir)/i_configurefonts.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configurefonts.png; + $(INSTALL_DATA) $(srcdir)/i_configure.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configure.png; + $(INSTALL_DATA) $(srcdir)/i_configurestart.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configurestart.png; + $(INSTALL_DATA) $(srcdir)/i_configuresword.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configuresword.png; + $(INSTALL_DATA) $(srcdir)/i_configuretoolbars.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configuretoolbars.png; + $(INSTALL_DATA) $(srcdir)/i_contents.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_contents.png; + $(INSTALL_DATA) $(srcdir)/i_delete.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_delete.png; + $(INSTALL_DATA) $(srcdir)/i_editdelete.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_editdelete.png; + $(INSTALL_DATA) $(srcdir)/i_exit.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_exit.png; + $(INSTALL_DATA) $(srcdir)/i_fileclose.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_fileclose.png; + $(INSTALL_DATA) $(srcdir)/i_fileprint.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_fileprint.png; + $(INSTALL_DATA) $(srcdir)/i_find.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_find.png; + $(INSTALL_DATA) $(srcdir)/i_fullscreen.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_fullscreen.png; + $(INSTALL_DATA) $(srcdir)/i_go.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_go.png; + $(INSTALL_DATA) $(srcdir)/i_ktip.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_ktip.png; + $(INSTALL_DATA) $(srcdir)/i_lexicon_add.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_lexicon_add.png; + $(INSTALL_DATA) $(srcdir)/i_lexicon.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_lexicon.png; + $(INSTALL_DATA) $(srcdir)/i_pencil.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_pencil.png; + $(INSTALL_DATA) $(srcdir)/i_sidetree.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_sidetree.png; + $(INSTALL_DATA) $(srcdir)/i_sync.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_sync.png; + $(INSTALL_DATA) $(srcdir)/i_tile_auto.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_tile_auto.png; + $(INSTALL_DATA) $(srcdir)/i_tile.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_tile.png; + $(INSTALL_DATA) $(srcdir)/ss_configfonts.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_configfonts.png; + $(INSTALL_DATA) $(srcdir)/ss_configtoolbar.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_configtoolbar.png; + $(INSTALL_DATA) $(srcdir)/ss_mainterms.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_mainterms.png; + $(INSTALL_DATA) $(srcdir)/ss_searchanal.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_searchanal.png; + $(INSTALL_DATA) $(srcdir)/ss_searchopts.png $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_searchopts.png; + +uninstall-local: + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_bible_add.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_bible.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_bibletime.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_book_add.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_book.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_cascade_auto.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_cascade.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_commentary_add.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_commentary.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configureaccels.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configuredisplay.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configurefonts.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configure.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configurestart.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configuresword.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_configuretoolbars.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_contents.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_delete.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_editdelete.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_exit.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_fileclose.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_fileprint.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_find.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_fullscreen.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_go.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_ktip.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_lexicon_add.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_lexicon.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_pencil.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_sidetree.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_sync.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_tile_auto.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/i_tile.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_configfonts.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_configtoolbar.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_mainterms.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_searchanal.png; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/ss_searchopts.png; diff --git a/doc/en/handbook/html/i_bible.png b/doc/en/handbook/html/i_bible.png Binary files differnew file mode 100644 index 0000000..5eff64d --- /dev/null +++ b/doc/en/handbook/html/i_bible.png diff --git a/doc/en/handbook/html/i_bible_add.png b/doc/en/handbook/html/i_bible_add.png Binary files differnew file mode 100644 index 0000000..41854e4 --- /dev/null +++ b/doc/en/handbook/html/i_bible_add.png diff --git a/doc/en/handbook/html/i_bibletime.png b/doc/en/handbook/html/i_bibletime.png Binary files differnew file mode 100644 index 0000000..4405521 --- /dev/null +++ b/doc/en/handbook/html/i_bibletime.png diff --git a/doc/en/handbook/html/i_book.png b/doc/en/handbook/html/i_book.png Binary files differnew file mode 100644 index 0000000..5c61816 --- /dev/null +++ b/doc/en/handbook/html/i_book.png diff --git a/doc/en/handbook/html/i_book_add.png b/doc/en/handbook/html/i_book_add.png Binary files differnew file mode 100644 index 0000000..e839b02 --- /dev/null +++ b/doc/en/handbook/html/i_book_add.png diff --git a/doc/en/handbook/html/i_cascade.png b/doc/en/handbook/html/i_cascade.png Binary files differnew file mode 100644 index 0000000..b9c5005 --- /dev/null +++ b/doc/en/handbook/html/i_cascade.png diff --git a/doc/en/handbook/html/i_cascade_auto.png b/doc/en/handbook/html/i_cascade_auto.png Binary files differnew file mode 100644 index 0000000..9b40021 --- /dev/null +++ b/doc/en/handbook/html/i_cascade_auto.png diff --git a/doc/en/handbook/html/i_commentary.png b/doc/en/handbook/html/i_commentary.png Binary files differnew file mode 100644 index 0000000..9ad8771 --- /dev/null +++ b/doc/en/handbook/html/i_commentary.png diff --git a/doc/en/handbook/html/i_commentary_add.png b/doc/en/handbook/html/i_commentary_add.png Binary files differnew file mode 100644 index 0000000..38415ee --- /dev/null +++ b/doc/en/handbook/html/i_commentary_add.png diff --git a/doc/en/handbook/html/i_configure.png b/doc/en/handbook/html/i_configure.png Binary files differnew file mode 100644 index 0000000..d0e5539 --- /dev/null +++ b/doc/en/handbook/html/i_configure.png diff --git a/doc/en/handbook/html/i_configureaccels.png b/doc/en/handbook/html/i_configureaccels.png Binary files differnew file mode 100644 index 0000000..069c86c --- /dev/null +++ b/doc/en/handbook/html/i_configureaccels.png diff --git a/doc/en/handbook/html/i_configuredisplay.png b/doc/en/handbook/html/i_configuredisplay.png Binary files differnew file mode 100644 index 0000000..a38cfbf --- /dev/null +++ b/doc/en/handbook/html/i_configuredisplay.png diff --git a/doc/en/handbook/html/i_configurefonts.png b/doc/en/handbook/html/i_configurefonts.png Binary files differnew file mode 100644 index 0000000..fc98267 --- /dev/null +++ b/doc/en/handbook/html/i_configurefonts.png diff --git a/doc/en/handbook/html/i_configurestart.png b/doc/en/handbook/html/i_configurestart.png Binary files differnew file mode 100644 index 0000000..f52aeef --- /dev/null +++ b/doc/en/handbook/html/i_configurestart.png diff --git a/doc/en/handbook/html/i_configuresword.png b/doc/en/handbook/html/i_configuresword.png Binary files differnew file mode 100644 index 0000000..4959ebb --- /dev/null +++ b/doc/en/handbook/html/i_configuresword.png diff --git a/doc/en/handbook/html/i_configuretoolbars.png b/doc/en/handbook/html/i_configuretoolbars.png Binary files differnew file mode 100644 index 0000000..8ee2111 --- /dev/null +++ b/doc/en/handbook/html/i_configuretoolbars.png diff --git a/doc/en/handbook/html/i_contents.png b/doc/en/handbook/html/i_contents.png Binary files differnew file mode 100644 index 0000000..9311691 --- /dev/null +++ b/doc/en/handbook/html/i_contents.png diff --git a/doc/en/handbook/html/i_delete.png b/doc/en/handbook/html/i_delete.png Binary files differnew file mode 100644 index 0000000..f78a2ec --- /dev/null +++ b/doc/en/handbook/html/i_delete.png diff --git a/doc/en/handbook/html/i_editdelete.png b/doc/en/handbook/html/i_editdelete.png Binary files differnew file mode 100644 index 0000000..da0ef31 --- /dev/null +++ b/doc/en/handbook/html/i_editdelete.png diff --git a/doc/en/handbook/html/i_exit.png b/doc/en/handbook/html/i_exit.png Binary files differnew file mode 100644 index 0000000..8b90671 --- /dev/null +++ b/doc/en/handbook/html/i_exit.png diff --git a/doc/en/handbook/html/i_fileclose.png b/doc/en/handbook/html/i_fileclose.png Binary files differnew file mode 100644 index 0000000..a4a5f3d --- /dev/null +++ b/doc/en/handbook/html/i_fileclose.png diff --git a/doc/en/handbook/html/i_fileprint.png b/doc/en/handbook/html/i_fileprint.png Binary files differnew file mode 100644 index 0000000..cc996db --- /dev/null +++ b/doc/en/handbook/html/i_fileprint.png diff --git a/doc/en/handbook/html/i_find.png b/doc/en/handbook/html/i_find.png Binary files differnew file mode 100644 index 0000000..83089cf --- /dev/null +++ b/doc/en/handbook/html/i_find.png diff --git a/doc/en/handbook/html/i_fullscreen.png b/doc/en/handbook/html/i_fullscreen.png Binary files differnew file mode 100644 index 0000000..cc8426a --- /dev/null +++ b/doc/en/handbook/html/i_fullscreen.png diff --git a/doc/en/handbook/html/i_go.png b/doc/en/handbook/html/i_go.png Binary files differnew file mode 100644 index 0000000..6f4d363 --- /dev/null +++ b/doc/en/handbook/html/i_go.png diff --git a/doc/en/handbook/html/i_ktip.png b/doc/en/handbook/html/i_ktip.png Binary files differnew file mode 100644 index 0000000..4a28220 --- /dev/null +++ b/doc/en/handbook/html/i_ktip.png diff --git a/doc/en/handbook/html/i_lexicon.png b/doc/en/handbook/html/i_lexicon.png Binary files differnew file mode 100644 index 0000000..0d68cb3 --- /dev/null +++ b/doc/en/handbook/html/i_lexicon.png diff --git a/doc/en/handbook/html/i_lexicon_add.png b/doc/en/handbook/html/i_lexicon_add.png Binary files differnew file mode 100644 index 0000000..63a0581 --- /dev/null +++ b/doc/en/handbook/html/i_lexicon_add.png diff --git a/doc/en/handbook/html/i_pencil.png b/doc/en/handbook/html/i_pencil.png Binary files differnew file mode 100644 index 0000000..6951c33 --- /dev/null +++ b/doc/en/handbook/html/i_pencil.png diff --git a/doc/en/handbook/html/i_sidetree.png b/doc/en/handbook/html/i_sidetree.png Binary files differnew file mode 100644 index 0000000..f7bf899 --- /dev/null +++ b/doc/en/handbook/html/i_sidetree.png diff --git a/doc/en/handbook/html/i_sync.png b/doc/en/handbook/html/i_sync.png Binary files differnew file mode 100644 index 0000000..ec7606b --- /dev/null +++ b/doc/en/handbook/html/i_sync.png diff --git a/doc/en/handbook/html/i_tile.png b/doc/en/handbook/html/i_tile.png Binary files differnew file mode 100644 index 0000000..9b979f1 --- /dev/null +++ b/doc/en/handbook/html/i_tile.png diff --git a/doc/en/handbook/html/i_tile_auto.png b/doc/en/handbook/html/i_tile_auto.png Binary files differnew file mode 100644 index 0000000..4519100 --- /dev/null +++ b/doc/en/handbook/html/i_tile_auto.png diff --git a/doc/en/handbook/html/ss_configfonts.png b/doc/en/handbook/html/ss_configfonts.png Binary files differnew file mode 100644 index 0000000..05e8ea6 --- /dev/null +++ b/doc/en/handbook/html/ss_configfonts.png diff --git a/doc/en/handbook/html/ss_configtoolbar.png b/doc/en/handbook/html/ss_configtoolbar.png Binary files differnew file mode 100644 index 0000000..783de9a --- /dev/null +++ b/doc/en/handbook/html/ss_configtoolbar.png diff --git a/doc/en/handbook/html/ss_mainterms.png b/doc/en/handbook/html/ss_mainterms.png Binary files differnew file mode 100644 index 0000000..a4c8a15 --- /dev/null +++ b/doc/en/handbook/html/ss_mainterms.png diff --git a/doc/en/handbook/html/ss_searchanal.png b/doc/en/handbook/html/ss_searchanal.png Binary files differnew file mode 100644 index 0000000..770289d --- /dev/null +++ b/doc/en/handbook/html/ss_searchanal.png diff --git a/doc/en/handbook/html/ss_searchopts.png b/doc/en/handbook/html/ss_searchopts.png Binary files differnew file mode 100644 index 0000000..057d962 --- /dev/null +++ b/doc/en/handbook/html/ss_searchopts.png diff --git a/doc/en/handbook/unicode/CMakeL10n.txt b/doc/en/handbook/unicode/CMakeL10n.txt new file mode 100644 index 0000000..03d866a --- /dev/null +++ b/doc/en/handbook/unicode/CMakeL10n.txt @@ -0,0 +1,14 @@ +##### create translation templates ############## + +file( GLOB _docs + RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} + ${CMAKE_CURRENT_SOURCE_DIR}/*.docbook +) +list( SORT _docs ) +list( REMOVE_ITEM _docs "index.docbook" ) +list( INSERT _docs 0 "index.docbook" ) + +tde_l10n_create_template( + CATALOG "handbook" + SOURCES ${_docs} +) diff --git a/doc/en/handbook/unicode/CMakeLists.txt b/doc/en/handbook/unicode/CMakeLists.txt new file mode 100644 index 0000000..fab9335 --- /dev/null +++ b/doc/en/handbook/unicode/CMakeLists.txt @@ -0,0 +1,7 @@ + +file( GLOB handbook_text *.docbook ) + +install( + FILES ${handbook_text} + DESTINATION ${HTML_INSTALL_DIR}/en/${PROJECT_NAME}/handbook +) diff --git a/doc/en/handbook/unicode/Makefile.am b/doc/en/handbook/unicode/Makefile.am new file mode 100644 index 0000000..ff6497b --- /dev/null +++ b/doc/en/handbook/unicode/Makefile.am @@ -0,0 +1,31 @@ +# this Makefile.am was automatically generated by bibletime/maintenance/gen_am.sh +# please do not edit this file but rather run the script to update + + +KDE_OPTIONS = noautodist +EXTRA_DIST = hdbk-config.docbook hdbk-intro.docbook hdbk-operation.docbook hdbk-reference.docbook hdbk-start.docbook index.docbook + + +install-data-local: + mkdir -p $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/; + chmod -R a+r+X $(DESTDIR)$(kde_htmldir)/en/bibletime; + $(INSTALL_DATA) $(srcdir)/hdbk-config.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-config.docbook; + $(INSTALL_DATA) $(srcdir)/hdbk-intro.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-intro.docbook; + $(INSTALL_DATA) $(srcdir)/hdbk-operation.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-operation.docbook; + $(INSTALL_DATA) $(srcdir)/hdbk-reference.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-reference.docbook; + $(INSTALL_DATA) $(srcdir)/hdbk-start.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-start.docbook; + $(INSTALL_DATA) $(srcdir)/index.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/index.docbook; + +uninstall-local: + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-config.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-intro.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-operation.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-reference.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/hdbk-start.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/handbook/index.docbook; diff --git a/doc/en/handbook/unicode/hdbk-config.docbook b/doc/en/handbook/unicode/hdbk-config.docbook new file mode 100644 index 0000000..94a037e --- /dev/null +++ b/doc/en/handbook/unicode/hdbk-config.docbook @@ -0,0 +1,182 @@ +<chapter id="hdbk-config"><title>Configuring &bibletime;</title> + +<para>In this section you find a description of the different possibilities +to configure &bibletime;: The <link linkend="hdbk-config-bt">Configure BibleTime Dialog +</link> and the <link linkend="hdbk-config-toolbar">Configure Toolbars</link> +dialog. Both can be accessed under <guimenu>Settings</guimenu> in the main menu.</para> + +<sect1 id="hdbk-config-bt"><title>Configure BibleTime Dialog</title> + + <para>The &bibletime; user interface can be customized in many ways + depending on your needs. You can access the configuration dialog by + selecting <menuchoice><guimenu>Settings</guimenu></menuchoice> + <guimenuitem>Configure &bibletime;</guimenuitem>.</para> + + <sect2 id="hdbk-config-bt-display"><title><guimenu>Display</guimenu></title> + + <para>The startup behavior can be customized. Select from the following options: + <itemizedlist> + <listitem><para>Show tip of the day</para></listitem> + <listitem><para>Show startup logo</para></listitem> + </itemizedlist> + </para> + <para>Display templates define the rendering of text (colors, size etc.). Various built-in templates are available. + If you select one, you will see a preview on the right pane.</para> + + </sect2> + + <sect2 id="hdbk-config-bt-languages"><title><guimenu>Languages</guimenu></title> + + <para>Here you can specify which language should be used for the biblical booknames. Set + this to your native language, if it is available, and you'll feel at home.</para> + + <para>By default, &bibletime; uses the &kde; general display font which can + be specified in the &kcontrolcenter;. You can override this font if neccessary. + Some languages require special fonts to be displayed correctly, and this dialog + allows you to specify a custom font for each language.</para> + + <mediaobject><imageobject> + <imagedata fileref="ss_configfonts.png" format="PNG"/> + </imageobject> + <textobject><phrase>Options Dialog - fonts</phrase></textobject> + <caption><para>The Options dialog - Fonts.</para></caption> + </mediaobject> + + <para>&bibletime; can now use all fonts supported by KDE/QT. + As long as the works you are interested in display correctly nothing + needs to be done here. If a work only displays as a series + of question marks (??????) or empty boxes, then you know that the standard + KDE display font does not contain the characters used in this work.</para> + + <para>To correct this, choose this work's language from the drop down menu. + Select the use custom font checkbox. Now select a font. For example, a font + that supports many languages is Code2000. If no installed font can display + the work you are interested in, try installing the &kde; localization + package for that language.</para> + + <sect3 id="hdbk-config-bt-addfont"><title>Installing fonts</title> + <para>Detailed font installation instructions are outside the scope of this handbook. + &kde;'s <ulink url="help:/kcontrol/index.html">KControl Center</ulink> contains + an excellent and easy to use font installation module. + Please read <ulink url="help:/kcontrol/kcmfontinst/index.html"> + its documentation</ulink>. For further information you might want to refer to the + <ulink url="http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/html_single/Unicode-HOWTO.html#toc4"> + Unicode HOWTO</ulink>.</para> + + <tip><para>If you use a small font like Clearlyu (about 22kb), &bibletime; + will run faster than with a large font like <trademark class="registered"> + Bitstream Cyberbit</trademark> (about 12Mb).</para></tip> + </sect3> + + <sect3 id="hdbk-config-bt-ob-font"><title>Obtaining Fonts</title> + <para>Fonts can be obtained from a number of sources:</para> + <itemizedlist> + <listitem><para>Your Linux distribution.</para></listitem> + <listitem><para>Your distribution's localization packages.</para></listitem> + <listitem><para>An existing <trademark class="registered">Microsoft Windows</trademark> installation on the same computer.</para></listitem> + <listitem><para>A font collection, such as are available from Adobe or Bitstream.</para></listitem> + <listitem><para>Online font collections.</para></listitem> + </itemizedlist> + + <para>Unicode fonts support more characters than other fonts, and some of these fonts are + available at no charge. None of available fonts includes all characters + defined in the Unicode standard, so you may want to use different fonts for different + languages.</para> + + <table> + <title>Unicode Fonts</title> + <tgroup cols="2"> + <tbody> + + <row><entry><ulink url="http://home.att.net/~jameskass/CODE2000.ZIP">Code2000</ulink></entry> + <entry>Perhaps the best free Unicode font, covering a wide range of characters.</entry></row> + + <row><entry><ulink url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&cat_id=FontDownloads"> + SIL unicode fonts</ulink></entry> + <entry>Excellent unicode fonts from the Summer Institute of Linguistics.</entry></row> + + <row><entry><ulink url="http://www.nongnu.org/freefont/">FreeFont</ulink></entry> + <entry>A new free unicode font initiative.</entry></row> + + <row><entry><ulink url="ftp://ftp.crosswire.org/pub/sword/iso/latest/FONTS">Crosswire's font directory</ulink></entry> + <entry>Several fonts available from the Crosswire Bible Society Ftp site.</entry></row> + + <row><entry><ulink url="ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows/">Bitstream CyberBit</ulink></entry> + <entry>Covers almost the entire range of Unicode, but might slow &bibletime; down because of its size.</entry></row> + + <row><entry>Clearlyu</entry> + <entry>Included in some distributions. Contains European, Greek, Hebrew, Thai.</entry></row> + + <row><entry><ulink url="http://bibliofile.mc.duke.edu/gww/fonts/Unicode.html">Caslon, Monospace, Cupola, Caliban</ulink></entry> + <entry>Partial coverage, see information on linked site.</entry></row> + </tbody> + </tgroup> + </table> + + <para>There are good Unicode font lists on the net, as the one by Christoph Singer + (<ulink url="http://www.slovo.info/unifonts.htm">Multilingual Unicode TrueType Fonts + in the Internet</ulink>), or the one by Alan Wood + (<ulink url="http://www.alanwood.net/unicode/fontsbyrange.html"> + Unicode character ranges and the Unicode fonts that support them</ulink>). + </para> + + </sect3> + </sect2> + + + <sect2 id="hdbk-config-bt-desk"><title><guimenu>Desk</guimenu></title> + + <para>Many features provided by the Sword backend can now be customized in + &bibletime;. These features are documented right in the dialog. You also have + the possibility to specify standard works that should be used when no specific work + is specified in a reference. An example: The standard Bible is used to display the content of + crossreferences in the Bible. When you hover over then, the Mag will show the content of the verses + referred to, according to the standard Bible you specified.</para> + + </sect2> + + <sect2 id="hdbk-config-bt-hotkeys"><title><guimenu>HotKeys</guimenu></title> + + <para>HotKeys are special key commands that can be used in the place of + the menu items and icons. A number of &bibletime;'s commands have + predefined HotKeys (see <link linkend="hdbk-reference-hotkeys">this section</link> + for a complete listing). Most of &bibletime;'s commands can be assigned + HotKeys here. This is very helpful to quickly access the functions that you need the most.</para> + + </sect2> + +</sect1> + + + <sect1 id="hdbk-config-toolbar"><title>Configure Toolbars dialog</title> + <para>You can adapt the toolbar to your needs. Please use the following entry in the main menu: + <variablelist> + <varlistentry> + <term><menuchoice> + <guimenu> + <inlinemediaobject><imageobject> + <imagedata fileref="i_configuretoolbars.png" format="PNG"/></imageobject> + </inlinemediaobject>Settings + </guimenu> + <guimenuitem>Configure toolbars</guimenuitem></menuchoice></term> + <listitem><para>Configure toolbars</para></listitem> + </varlistentry> + </variablelist> + </para> + <para>You will see this dialog, which allows adding and removing buttons from + the main toolbar of &bibletime;. The order of the buttons can also be changed. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="ss_configtoolbar.png" format="PNG"/> + </imageobject> + <textobject><phrase>Toolbar configuration dialog</phrase></textobject> + <caption><para>The Toolbar configuration dialog.</para></caption> + </mediaobject> + <para>Use the 4 buttons in the middle of the window to move buttons to the toolbar, + away from the toolbar or to sort them on the toolbar according to your preference. + </para> + <para>Please see <link linkend="hdbk-reference-menus-settings-toolbars">this section</link> for further information.</para> + </sect1> + +</chapter> diff --git a/doc/en/handbook/unicode/hdbk-intro.docbook b/doc/en/handbook/unicode/hdbk-intro.docbook new file mode 100644 index 0000000..811363d --- /dev/null +++ b/doc/en/handbook/unicode/hdbk-intro.docbook @@ -0,0 +1,93 @@ +<chapter id="hdbk-intro"><title>Introduction</title> + +<sect1 id="hdbk-intro-about"><title>About BibleTime</title> + <para> + &bibletime; is a powerful Bible study tool written for the &kde; environment on the + Linux operating system. It is based on the <ulink + url="http://www.crosswire.org/sword">Sword</ulink> library, which provides the back-end + functionality for &bibletime;, such as viewing Bible text, searching + etc. Sword is the flagship product of the <ulink + url="http://www.crosswire.org">Crosswire Bible Society</ulink>. </para> + + <para>&bibletime; is designed to be used with works encoded in one of the formats + supported by the Sword project. + Complete information on the supported document formats can be found in the <ulink + url="http://www.crosswire.org/sword/develop/index.jsp"> + developers section</ulink> of the Sword Project, Crosswire Bible Society.</para> + +<sect2 id="hdbk-intro-works"><title>Available works</title> + + <para> + Over 200 documents in 50 languages are available from the <ulink + url="http://www.crosswire.org">Crosswire Bible Society</ulink>. These include: + + <variablelist> + <varlistentry> + <term>Bibles</term> + <listitem> + <para> + The full Bible text, with optional things like Strong's Numbers, headings and/or footnotes in the text. Bibles are available in many languages, and include not only modern versions, but also + ancient texts like the Codex Leningradensis ("WLC", Hebrew), and the Septuagint ("LXX", Greek). This is the most advanced section in the library of the Sword project. + </para> + </listitem></varlistentry> + + <varlistentry> + <term>Books</term> + <listitem> + <para>Books available include "Imitation of Christ", "Enuma Elish", and "Josephus: The Complete Works" + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Commentaries</term> + <listitem> + <para> + Commentaries available include classics like John Wesley's "Notes on the Bible", Matthew Henry`s commentary and Luther's "Commentary on Galatians." With the <emphasis>Personal</emphasis> commentary you can <link linkend="hdbk-op-parts-desk-write">record your own personal notes</link> to sections of the Bible. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Daily devotionals</term> + <listitem> + <para>Many people appreciate these daily portions from God's word. Available works include Daily Light on the Daily Path, and the Losungen. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Lexicons/Dictionaries</term> + <listitem> + <para> + Lexicons available include: Robinson's Morphological Analysis Codes, + Brown-Driver-Briggs Hebrew Lexicon and the International Standard Bible Encyclopedia. Dictionaries available include Strong's Hebrew Bible Dictionary, Strong's Greek Bible Dictionary, Webster's Revised Unabridged Dictionary of the English Language 1913, Nave's Topical Bible. + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> +</sect2> + +<sect2 id="hdbk-intro-motivation"><title>Motivation</title> + <para> + Our desire is to serve God, and to do our part to help others grow in their + relationship with Him. + We have striven to make this a powerful, quality program, and still make it + simple and intuitive to operate. It is our desire that God be praised, as He is + the source of all good things. + </para> + <blockquote><attribution>James 1:17, NASB</attribution> + <para>Every good thing given and every perfect gift is from above, + coming down from the Father of lights, with whom there is no + variation or shifting shadow.</para> + </blockquote> + <para> + God bless you as you use this program. + </para> +</sect2> + +</sect1> + +</chapter> diff --git a/doc/en/handbook/unicode/hdbk-operation.docbook b/doc/en/handbook/unicode/hdbk-operation.docbook new file mode 100644 index 0000000..46ad308 --- /dev/null +++ b/doc/en/handbook/unicode/hdbk-operation.docbook @@ -0,0 +1,260 @@ +<chapter id="hdbk-op"><title>Program operation</title> + +<sect1 id="hdbk-op-overview"> +<title>Program overview</title> + +<para>This is how a typical &bibletime; session looks like: + +<mediaobject> +<imageobject> +<imagedata fileref="ss_mainterms.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>The &bibletime; application window</phrase> </textobject> +</mediaobject> + +You can easily see the different parts of the application. The Bookshelf on the left side is used to open works and to manage your bookmarks. The little "Mag" window below the Bookshelf is used to display extra information that is embedded in documents. When you move your mouse over a footnote marker, for example, then the Mag will display the actual content of the footnote. The toolbar gives you quick access to important functions, and the Desk on the right side is where you do your real work.</para> +<para>Let us now proceed by looking at the different parts of the application individually.</para> +</sect1> + +<sect1 id="hdbk-op-parts"> +<title>Parts of the &bibletime; application window</title> + +<sect2 id="hdbk-op-parts-bookshelf"> +<title>The Bookshelf</title> +<para>The Bookshelf lists all installed works, sorted by category and language. It also has a category called "Bookmarks". This is where you can store and access your own bookmarks. +</para> + +<sect3 id="hdbk-op-parts-bookshelf-open"> +<title>Reading works</title> +<para>To open a work from the bookshelf for reading, simply click with the <mousebutton>left mouse button</mousebutton> on the desired +category (Bibles, Commentaries, Lexicons, Books, Devotionals or Glossaries) to display its contents. Then just click on one of the works to open it for reading. A read window will appear in the Desk area. +</para> +<tip><para>Drag & Drop Works Here</para></tip> +<para> +If you are reading a certain work, and want to open another work at the passage you are reading, you can use a shortcut. Simply click with the <mousebutton>left mouse button</mousebutton> on the verse/passage reference (pointer changes to hand) and drag it to the +Bookshelf. Drop it on the work you want to open, and it will be opened for reading at the specified location. You can also drag a verse reference into an existing read window, then it will jump to the specified location.</para> +</sect3> + +<sect3 id="hdbk-op-parts-bookshelf-metainfo"> +<title>Additional information about works</title> +<para> +If you click with the <mousebutton>right</mousebutton> mouse button on +the symbol of a work, you will see a menu with additional entries that are relevant for this work. <guimenuitem>"About this work"</guimenuitem> opens a window with lots of interesting information about the selected work. <guimenuitem>"Unlock this work"</guimenuitem> opens a small dialog for encrypted documents, where you can enter the unlock key to access the work. +For additional information on locked works, please see <ulink url="http://www.crosswire.org/sword/modules/aboutlocked.jsp">this page</ulink> on the Crosswire Bible Society web site. +</para> +</sect3> + +<sect3 id="hdbk-op-parts-bookshelf-search"> +<title>Searching in works</title> <para> +You can search in a work by clicking with the <mousebutton>right</mousebutton> +mouse button on its symbol and selecting <guimenuitem>"Search in work(s)"</guimenuitem>. By pressing &Shift; and clicking on other works you can select more than one. Then follow the same procedure to open the search dialog. You will be searching in all of these documents. A complete description of the operation of the search features can be +found <link linkend="hdbk-op-search">here</link>. +</para> +</sect3> + +<sect3 id="hdbk-op-parts-bookshelf-bookmarks"> +<title>Working with bookmarks</title> +<para> +<tip><para>Drag & Drop Works Here</para></tip> +Click with the <mousebutton>right</mousebutton> mouse button on the bookmark category of the bookshelf and select <guimenuitem>"Create new folder"</guimenuitem> to create a new bookmark subfolder. You can use normal drag & drop +functions to drag verse references from read windows or search results to the bookmark folder, and to rearrange bookmarks between folders.</para> + +<para>You can also import bookmarks from other people or export bookmarks to share them. To do this, open the <guimenu>context menu</guimenu> of the bookmark folder as described above, and select <guimenuitem>"Export bookmarks"</guimenuitem>. This will bring up a dialog box for you to save the bookmark collection. You can import bookmarks in a similar way.</para> + +<para>You can also click with the <mousebutton>right</mousebutton> on folders and bookmarks to change their names and descriptions.</para> +</sect3> +</sect2> + +<sect2 id="hdbk-op-parts-mag"> +<title>The Mag(nifying glass)</title> +<para>This little window in the lower left corner of the &bibletime; window is purely passive. Whenever your mouse cursor is located over some text with additional information (e.g., Strong's numbers), then this additional information will be displayed in the Mag, and not in the text itself. Just try it out.</para> +</sect2> + + +<sect2 id="hdbk-op-parts-desk"> +<title>The Desk</title> +<para> +The Desk is where the real work with &bibletime; takes place. Here you can open works from the Bookshelf, read them, <link linkend="hdbk-op-search">search</link> in them, and even save your annotations in the personal commentary module (see <link linkend="hdbk-op-parts-desk-write">below</link>).</para> + +<sect3 id="hdbk-op-parts-desk-read"> +<title>Reading works</title> +<para> +As we have <link linkend="hdbk-op-parts-bookshelf-open">already seen</link>, you can open works for reading simply by clicking on their symbol in the Bookshelf. A read window will open in the Desk's area. Every read window has a toolbar. There you can find tools to navigate in the work that this read window is connected to, as well as history buttons like the ones that you know from your browser.</para> +</sect3> + +<sect3 id="hdbk-op-parts-desk-placement"> +<title>Read window placement</title> +<para> +Of course, you can open multiple works at the same time. There are several possibilities for arranging the read windows on the desk. Please have a look at the entry <guimenu>Window</guimenu> in the main menu. There you can see that you can either control the placement of the read windows completely yourself, or have &bibletime; handle the placement automatically. To achieve this, you have to select one of the automatic placement modes available at <menuchoice><guimenu>Window</guimenu><guimenuitem>Arrangement mode</guimenuitem></menuchoice>. Just try it out, it's simple and works. +</para> +</sect3> + +<sect3 id="hdbk-op-parts-desk-write"> +<title>Editing your own commentary</title> +<para> +To be able to store your own comments about parts of the Bible, you have install a certain work from the library of the <ulink url="http://www.crosswire.org">Crosswire Bible Society</ulink>. This work is called "Personal commentary".</para> +<para> +If you open the personal commentary by clicking on its symbol in the Bookshelf with a <mousebutton>left</mousebutton> mouse button, it opens +in read mode. You will not be able to edit it in this mode. Should you wish to write annotations into the personal commentary, you have to open it with the <mousebutton>right</mousebutton> mouse button and then select <guimenu>Edit this work</guimenu> and then either <guimenuitem>Plain text</guimenuitem>(source code editor) or <guimenuitem>HTML</guimenuitem>(basic gui wysiwyg editor).</para> + +<tip><para>If <menuchoice><guimenu>Edit this work</guimenu></menuchoice> +is deactivated, please check if you have write permission for the files of +the personal commentary.</para></tip> + +<tip><para>Drag&drop works here. Drop a verse reference and the text +of the verse will be inserted.</para></tip> +</sect3> + +</sect2> + +</sect1> + + +<sect1 id="hdbk-op-search"> +<title>Searching in works</title> + +<sect2 id="hdbk-op-search-intext"> +<title>Searching text in an open read window</title> +<para> +You can look for a word or phrase in the open read window (e.g. the chapter of a bible that you're reading) +just like you are used to from other programs. +This function can be reached either by clicking with the <mousebutton>right</mousebutton> mouse button and +selecting <guimenuitem>Find...</guimenuitem>, or by using the hotkey <keycombo action="simul">&Ctrl;<keycap>F</keycap> </keycombo>. Read on to learn how you can search in entire works.</para> +</sect2> + +<sect2 id="hdbk-op-search-access"> +<title>Accessing the search dialog</title> +<para> +You can search in a work by clicking with the <mousebutton>right</mousebutton> mouse button +on its symbol in the <guimenu>Bookshelf</guimenu> and selecting <guimenuitem>Search in work(s)</guimenuitem>. By holding &Shift; or &Ctrl; and clicking on other work's names you can select more than one. Then follow the same procedure to open the search dialog. You will be searching in all of these works at the same time.</para> +<para>You can also access the search dialog by clicking on <menuchoice><guimenu>Search</guimenu></menuchoice> from the main menu, and selecting the appropriate entry.</para> +<para>A third possibility to start searches is to click on the search symbol in an open read window.</para> +</sect2> + +<sect2 id="hdbk-op-search-config"> +<title>Search configuration</title> +<screenshot> +<screeninfo>Search Text Dialog Options Tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="ss_searchopts.png" format="PNG"/> +</imageobject> +</mediaobject> +</screenshot> + +<sect3 id="hdbk-op-search-config-works"> +<title>Selecting works</title> +<para>At the top of the options tab you will find <guibutton>Choose</guibutton> (works). If you would like to search in multiple works, click on this button and you will be offered a menu where you can select the works you want to search in. +</para> +</sect3> + +<sect3 id="hd-op-search-config-scope"> +<title>Using Search Scopes</title> +<para>You can narrow the scope of your search to certain parts of the Bible by selecting one of the predefined scopes from the list in <guimenu>Search scope</guimenu>. You can define your own search ranges by clicking the <guibutton>Setup ranges</guibutton> button.</para> +</sect3> + +<sect3 id="hd-op-search-config-syntax"> +<title>Basic Search Syntax Introduction</title> +<para>Enter search terms separated by spaces. By default the search function will return results that match any of the search terms (OR). To search for all the terms separate the terms by AND.</para> +<para>You can use wildcards: '*' matches any sequence of characters, while '?' matches any single character. The use of brackets allows you to group your search terms, e.g. '(Jesus OR spirit) AND God'.</para> +<para>To search text other than the main text, enter the text type followed by ':', and then the search term. For example, to search for the Strong's number H8077, use 'strong:H8077'.</para> +<para>Available text types: +<table><tgroup cols="2"> +<thead><row><entry>Prefix</entry><entry>Meaning</entry></row></thead> +<tbody> +<row><entry>heading:</entry><entry>searches headings</entry></row> +<row><entry>footnote:</entry><entry>searches footnotes</entry></row> +<row><entry>strong:</entry><entry>searches Strong's Numbers</entry></row> +<row><entry>morph:</entry><entry>searches morphology codes</entry></row> +</tbody></tgroup></table></para> +<para>BibleTime uses the Lucene search engine to perform your searches. It has many advanced features, and you can read more about it here: <ulink url="http://lucene.apache.org/java/docs/queryparsersyntax.html">http://lucene.apache.org/java/docs/queryparsersyntax.html</ulink></para> +</sect3> + + +</sect2> + +<sect2 id="hdbk-op-search-results"> +<title>Search results</title> +<para> +Here you can see how many instances of the search string were found, sorted by works. +Clicking on a work with the <mousebutton>right</mousebutton> mouse button allows you to copy, save, or print all verses that were found in a certain work at once. This also works when you click on one or more of the references to copy, save or print them. Clicking on a particular reference opens that verse up in context in the preview window below.</para> + +<tip><para>Drag a reference and drop it on a work symbol on the Bookshelf to open the +work at that verse in a new read window.</para></tip> +<tip><para>Drag a reference and drop it on an open read window, and it will jump to that verse.</para></tip> +<tip><para>Select references and drag them to the Bookshelf to create bookmarks.</para></tip> + +<sect3 id="hdbk-op-search-analysis"> +<title>Search result analysis</title> +<para>Click on <guibutton>Search analysis</guibutton> to open the search analysis display. +This gives a simple graphic analysis of the number of instances the +search string was found in each book of the Bible, and you can also save the analysis.</para> + +<screenshot> +<screeninfo>Search Analysis Dialog Box</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="ss_searchanal.png" format="PNG"/> +</imageobject> +</mediaobject> +</screenshot> +</sect3> +</sect2> +</sect1> + + + +<sect1 id="hdbk-op-bookshelfmanager"> +<title>The <guimenuitem>Bookshelf Manager</guimenuitem></title> + +<para>The <guimenuitem>Bookshelf Manager</guimenuitem> is a tool to manage your Bookshelf. You can install new works to your Bookshelf, and update or remove existing works from your Bookshelf. Access it by clicking <menuchoice><guimenu>Settings</guimenu><guimenuitem>Bookshelf Manager</guimenuitem></menuchoice> in the main menu.</para> + +<sect2 id="hdbk-op-bookshelfmanager-path"> +<title>Bookshelf path(s) setup</title> + +<para>Here you can specify where &bibletime; may store your Bookshelf on the harddrive. You can even store it in multiple directories. Default is "~/.sword/".</para> + +<tip><para>If you have a sword CD, but do not want to install all the works on the harddisk, but use them directly from the CD, then you can add the path to the CD as one of your bookshelf paths. When you start &bibletime;, it will show all works on the CD if it is present.</para></tip> +</sect2> + +<sect2 id="hdbk-op-bookshelfmanager-installupdate"> +<title>Install/update work(s)</title> + +<para>With this facility, you can connect to a repository of works (called "library"), and transfer one or more works to your local Bookshelf. These libraries may be local (e.g. a Sword CD), or remote (e.g. Crosswire's online repository of Sword modules, or another site offering Sword modules). You can manage your libraries with <guibutton>Add library</guibutton> and <guibutton>Delete library</guibutton>.</para> + +<para>To begin the installation or update process, select a library you want to connect to and a local Bookshelf path to install the work(s) to. Then click on <guibutton>Connect to library</guibutton>. &bibletime; will scan the contents of the library and present you with a list of works that you can add to your Bookshelf, or that you already have installed but are available in a new version in the library, and thus can be updated. Then you can mark all works that you want to install or update, and click on <guibutton>Install works</guibutton>. They will then be transferred to your Bookshelf. +</para> +</sect2> + +<sect2 id="hdbk-op-bookshelfmanager-remove"> +<title>Remove work(s)</title> + +<para>This facility allows you to delete one or more of the works from your Bookshelf too free up disk space. Simply mark the items and click on <guibutton>Remove works</guibutton>. +</para> + +</sect2> + +</sect1> + +<sect1 id="hdbk-op-output"> +<title>Exporting and Printing</title> + +<para> +In many places, you can open a context menu by clicking with the +<mousebutton>right</mousebutton> mouse button. Depending on context, it will allow you +to <guimenuitem>Select</guimenuitem>, <guimenuitem>Copy</guimenuitem> (to clipboard), <guimenuitem>Save</guimenuitem> or <guimenuitem>Print</guimenuitem> text. This works for example in the read windows, when you click on the normal text or the verse reference, or in the search result page when you click on a work or one or more verse references. It is pretty straightforward, so just try it out.</para> + +<para>Printing from &bibletime; is rather basic and is intended as +a utility. If you are composing a document or presentation containing text from +&bibletime; works, we suggest that you use one of the presentation or editing +tools on your system to format your document, rather than printing from &bibletime; directly. +</para> + +</sect1> + +</chapter> + + + + diff --git a/doc/en/handbook/unicode/hdbk-reference.docbook b/doc/en/handbook/unicode/hdbk-reference.docbook new file mode 100644 index 0000000..f23872b --- /dev/null +++ b/doc/en/handbook/unicode/hdbk-reference.docbook @@ -0,0 +1,480 @@ +<chapter id="hdbk-reference"> +<title>Reference</title> + +<sect1 id="hdbk-reference-menus"><title>Main menu reference</title> + + <para>In this section you can find detailed descriptions of all entries in the main menu + of &bibletime;. They are ordered in just the way they appear in &bibletime;, with + all the sub-items listed under the major menu item they belong to. You can also see + the hotkey of each item;a complete listing of all hotkeys can be found in + <link linkend="hdbk-reference-hotkeys">this section</link>.</para> + + <sect2 id="hdbk-reference-menus-file"><title><guimenu>File</guimenu></title> + + <para> + <variablelist> + + <varlistentry id="hdbk-reference-menus-file-quit"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_exit.png" format="PNG"/></imageobject></inlinemediaobject> + File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice></term> + <listitem><para><action>Closes BibleTime.</action> BibleTime will ask you if + you want to write unsaved changes to disk.</para></listitem> +</varlistentry> + + </variablelist> + </para> + </sect2> + + <sect2 id="hdbk-reference-menus-view"><title><guimenu>View</guimenu></title> + + <variablelist> + <varlistentry id="hdbk-reference-menus-view-showtoolbar"> + <term><menuchoice> + <guimenu>View</guimenu> <guimenuitem>Show Toolbar</guimenuitem></menuchoice></term> + <listitem><para><action>Toggles Toolbar display.</action> Toggle this setting to turn the main toolbar + on or off.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-view-showbookshelf"> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_sidetree.png" format="PNG"/></imageobject></inlinemediaobject> + View</guimenu> <guimenuitem>Show Bookshelf</guimenuitem></menuchoice></term> + <listitem><para><action>Toggles display of the Bookshelf.</action> Toggle this setting to turn the + Bookshelf on the left pane on or off. This can be handy if you need more space for the Mag.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-view-showmag"> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>F8</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_sidetree.png" format="PNG"/></imageobject></inlinemediaobject> + View</guimenu> <guimenuitem>Show Mag</guimenuitem></menuchoice></term> + <listitem><para><action>Toggles display of the Mag(nifying glass).</action> Toggle this setting to turn the + Mag on the left pane on or off.</para></listitem> + </varlistentry> + + </variablelist> + </sect2> + + <sect2 id="hdbk-reference-menus-search"><title><guimenu>Search</guimenu></title> + <variablelist> + + <varlistentry id="hdbk-reference-menus-search-defaultbible"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Alt;&Ctrl;<keycap>F</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_find.png" format="PNG"/></imageobject></inlinemediaobject> + Search</guimenu> <guimenuitem>Search in standard bible</guimenuitem></menuchoice></term> + <listitem><para><action>Opens the Search Dialog to search in the standard Bible only</action>. + More works can be added in the Search Dialog.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-search-openworks"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_find.png" format="PNG"/></imageobject></inlinemediaobject> + Search</guimenu> <guimenuitem>Search in open work(s)</guimenuitem></menuchoice></term> + <listitem><para><action>Opens the Search Dialog to search in all open works</action>. + More works can be added in the Search Dialog.</para></listitem> + </varlistentry> + + </variablelist> + + </sect2> + + <sect2 id="hdbk-reference-menus-window"><title><guimenu>Window</guimenu></title> + <variablelist> + + <varlistentry id="hdbk-reference-menus-window-savesession"> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_sidetree.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Save session</guimenuitem></menuchoice></term> + <listitem><para><action>Directly saves the current session</action>. + This will open a context menu where you can select an existing session to save to. + It will be overwritten with your current session. See the next item on how to save to a new session.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-savenewsession"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Alt;&Ctrl;<keycap>S</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_sidetree.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Save as new Session</guimenuitem></menuchoice></term> + <listitem><para><action>Saves the current session under a new name</action>. + This will ask for a new name to save the session to.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-loadsession"> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_sidetree.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Load session</guimenuitem></menuchoice></term> + <listitem><para><action>Loads an existing session</action>. + This will open a context menu where you can select an existing session to load.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-deletesession"> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_sidetree.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Delete session</guimenuitem></menuchoice></term> + <listitem><para><action>Deletes an existing session</action>. + This will open a context menu where you can select an existing session that should be deleted.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-fullscreen"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_fullscreen.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Fullscreen Mode</guimenuitem></menuchoice></term> + <listitem><para><action>Toggles fullscreen mode</action>. + Here you can turn fullscreen mode on or off. In fullscreen mode, &bibletime; will expand to the full size + of your monitor screen, using as much space as possible.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-arrangement_mode"> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_cascade_auto.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Arrangement mode</guimenuitem></menuchoice></term> + <listitem><para><action>Controls the basic window arrangement behaviour</action>. + In the opening context menu, you can either specify that you want to take care of + the window arrangement yourself (Manual mode) or have &bibletime; handle it for you + (Automatical modes, just try them out!).</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-tile-vertically"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_tile.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Tile vertically</guimenuitem></menuchoice></term> + <listitem><para><action>Tiles all open read windows vertically</action>.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-tile-horizontally"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_tile.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Tile horizontally</guimenuitem></menuchoice></term> + <listitem><para><action>Tiles all open windows horizontally</action>.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-cascade"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_cascade.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Cascade</guimenuitem></menuchoice></term> + <listitem><para><action>Cascades all open windows</action>.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-window-closeall"> + <term><menuchoice> + <shortcut><keycombo action="simul">&Alt;&Ctrl;<keycap>W</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_fileclose.png" format="PNG"/></imageobject></inlinemediaobject> + Window</guimenu> <guimenuitem>Close all</guimenuitem></menuchoice></term> + <listitem><para><action>Closes all open windows</action>.</para></listitem> + </varlistentry> + + </variablelist> + </sect2> + + <sect2 id="hdbk-reference-menus-settings"><title><guimenu>Settings</guimenu></title> + <variablelist> + + <varlistentry id="hdbk-reference-menus-settings-toolbars"> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_configuretoolbars.png" format="PNG"/></imageobject></inlinemediaobject> + Settings</guimenu> <guimenuitem>Configure toolbars</guimenuitem></menuchoice></term> + <listitem><para><action>Opens a dialog where you can customize &bibletime;'s toolbar</action>. + Just try it out, you can move around the toolbar buttons and even add new ones. Most of the entries available from + the main menu can be put on the toolbar as buttons. If you need a certain feature often, you might want to + put a button on the main menu, so that you can access it with only one click. Please see <link linkend="hdbk-config-toolbar">this section</link> for further information.</para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-settings-bibletime"> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_configure.png" format="PNG"/></imageobject></inlinemediaobject> + Settings</guimenu> <guimenuitem>Configure &bibletime;</guimenuitem></menuchoice></term> + <listitem><para><action>Opens &bibletime;'s main configuration dialog</action>. + You can configure all kinds of nice settings there to adapt &bibletime; to your needs. + Please see <link linkend="hdbk-config-bt">this section</link> for details. + </para></listitem> + </varlistentry> + + <varlistentry id="hdbk-reference-menus-settings-bookshelf_manager"> + <term><menuchoice> + <shortcut><keycombo action="simul"><keycap>F4</keycap></keycombo></shortcut> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_configuresword.png" format="PNG"/></imageobject></inlinemediaobject> + Settings</guimenu> <guimenuitem>Bookshelf Manager</guimenuitem></menuchoice></term> + <listitem><para><action>Opens a dialog where you can change your Sword configuration and + manage your bookshelf</action>. + Please see <link linkend="hdbk-op-bookshelfmanager">this section</link> for details. + </para></listitem> + </varlistentry> + + </variablelist> + </sect2> + + + <sect2 id="hdbk-reference-menus-help"><title><guimenu>Help</guimenu></title> + + &help.menu.documentation; + + </sect2> + +</sect1> + +<sect1 id="hdbk-reference-toolbar"><title>Toolbar reference</title> + + <para>Please review <link linkend="hdbk-reference-menus">the preceding section</link> + for an explanation of the buttons that you find on the toolbar. You can also + <action>move the cursor over a button and wait a few seconds</action> to activate + the button's tooltip with a short description.</para> + <para>You can adapt the toolbar to your needs. Please use the following entry in the main menu: + <variablelist> + <varlistentry> + <term><menuchoice> + <guimenu> <inlinemediaobject><imageobject> + <imagedata fileref="i_configuretoolbars.png" format="PNG"/></imageobject></inlinemediaobject> + Settings</guimenu> <guimenuitem>Configure toolbars</guimenuitem></menuchoice></term> + <listitem><para>Configure toolbars</para></listitem> + </varlistentry> + </variablelist> + Please see <link linkend="hdbk-reference-menus-settings-toolbars">this section</link> for detailed instructions. + </para> + +</sect1> + +<sect1 id="hdbk-reference-hotkeys"> +<title>HotKeys index</title> + +<para>This is index of all hotkeys and their corresponding description in +the handbook. The hotkeys are sorted (roughly) alphabetical. If you want to directly +find out which hotkey a certain menu item has, you can either look at the entry itelf +in &bibletime; (as it always shows the hotkey), or you can look it up in +<link linkend="hdbk-reference-menus">this section</link>.</para> + +<informaltable> +<tgroup cols="2"> +<colspec colname="hotkey"/> +<colspec colname="desc"/> +<thead> +<row> + <entry>Hotkey</entry> + <entry>Description</entry> +</row> +</thead> +<tbody> +<row> + <entry><keycombo action="simul">&Alt;<keycap>Left</keycap> </keycombo></entry> + <entry>Moves back in the history of read windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;<keycap>Right</keycap> </keycombo></entry> + <entry>Moves forward in the history of read windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>F</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-search-defaultbible"><menuchoice> + <guimenu>Search</guimenu> + <guimenuitem>Search in default bible</guimenuitem></menuchoice></link> equivalent; + opens the search dialog to search in the default bible.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>G</keycap> </keycombo></entry> + <entry><menuchoice><guimenu>Window</guimenu><guimenuitem>Arrangement mode</guimenuitem> + <guimenuitem>Auto-tile vertically</guimenuitem></menuchoice> equivalent; + toggle automatic window tiling.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>H</keycap> </keycombo></entry> + <entry><menuchoice><guimenu>Window</guimenu><guimenuitem>Arrangement mode</guimenuitem> + <guimenuitem>Auto-tile horizontally</guimenuitem></menuchoice> equivalent; + toggle automatic window tiling.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>J</keycap> </keycombo></entry> + <entry><menuchoice><guimenu>Window</guimenu><guimenuitem>Arrangement mode</guimenuitem> + <guimenuitem>Auto-cascade</guimenuitem></menuchoice> equivalent; + toggle automatic window cascading.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>M</keycap> </keycombo></entry> + <entry><menuchoice><guimenu>Window</guimenu><guimenuitem>Arrangement mode</guimenuitem> + <guimenuitem>Manual mode</guimenuitem></menuchoice> equivalent; + toggle manual window placement.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>S</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-window-savenewsession"><menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Save as new session</guimenuitem></menuchoice></link> equivalent; + saves current layout as new session.</entry> +</row> +<row> + <entry><keycombo action="simul">&Alt;&Ctrl;<keycap>W</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-window-closeall"><menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Close all</guimenuitem></menuchoice></link> equivalent; + closes all open windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>-</keycap> </keycombo></entry> + <entry>Zoom out. This decreases the font size of read windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>+</keycap> </keycombo></entry> + <entry>Zoom in. This increases the font size of read windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>A</keycap> </keycombo></entry> + <entry>Select all. This selects all text in read windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>C</keycap> </keycombo></entry> + <entry>Copy. This copies the selected text to the clipboard.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>F</keycap> </keycombo></entry> + <entry>Search. This lets you search within the text of a read window.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>J</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-window-cascade"><menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Cascade</guimenuitem></menuchoice></link> equivalent; + cascades all open windows.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>G</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-window-tile-vertically"><menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Tile vertically</guimenuitem></menuchoice></link> equivalent; + tiles all open windows vertically.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>H</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-window-tile-horizontally"><menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Tile horizontally</guimenuitem></menuchoice></link> equivalent; + tiles all open windows horizontally.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>O</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-search-openworks"><menuchoice> + <guimenu>Search</guimenu> + <guimenuitem>Search in open work(s)</guimenuitem></menuchoice></link> equivalent; + opens the search dialog to search in all currently opened works.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-file-quit"><menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Quit</guimenuitem></menuchoice></link> equivalent; + closes &bibletime;.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>W</keycap> </keycombo></entry> + <entry>Closes the current window.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>X</keycap> </keycombo></entry> + <entry>Moves a bible or commentary read window to the next chapter.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>Y</keycap> </keycombo></entry> + <entry>Moves a bible or commentary read window to the next book.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;<keycap>V</keycap> </keycombo></entry> + <entry>Moves a read window to the next verse or entry.</entry> +</row> + + +<row> + <entry><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-window-fullscreen"><menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Fullscreen mode</guimenuitem></menuchoice></link> equivalent; + toggles fullscreen mode.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;&Shift;<keycap>X</keycap> </keycombo></entry> + <entry>Moves a bible or commentary read window to the previous chapter.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Y</keycap> </keycombo></entry> + <entry>Moves a bible or commentary read window to the previous book.</entry> +</row> +<row> + <entry><keycombo action="simul">&Ctrl;&Shift;<keycap>V</keycap> </keycombo></entry> + <entry>Moves a read window to the previous verse or entry.</entry> +</row> + +<row> + <entry><keycombo action="simul"><keycap>F1</keycap> </keycombo></entry> + <entry><menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>Handbook</guimenuitem></menuchoice> equivalent; + opens the handbook.</entry> +</row> +<row> + <entry><keycombo action="simul"><keycap>F2</keycap> </keycombo></entry> + <entry><menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>BibleStudy Howto</guimenuitem></menuchoice> equivalent; + opens the BibleStudy Howto.</entry> +</row> +<row> + <entry><keycombo action="simul"><keycap>F3</keycap> </keycombo></entry> + <entry><menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>Daily tip</guimenuitem></menuchoice> equivalent; + opens the tip of the day.</entry> +</row> +<row> + <entry><keycombo action="simul"><keycap>F4</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-settings-bookshelf_manager"><menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Bookshelf Manager</guimenuitem></menuchoice></link> equivalent; + opens the Bookshelf Manager.</entry> +</row> +<row> + <entry><keycombo action="simul"><keycap>F8</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-view-showbookshelf"><menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Bookshelf</guimenuitem></menuchoice></link> equivalent; + toggles display of the Bookshelf.</entry> +</row> +<row> + <entry><keycombo action="simul"><keycap>F9</keycap> </keycombo></entry> + <entry><link linkend="hdbk-reference-menus-view-showmag"><menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show mag</guimenuitem></menuchoice></link> equivalent; + toggles display of the mag(nifying glass).</entry> +</row> + + +</tbody> +</tgroup> +</informaltable> + +</sect1> + +</chapter> + diff --git a/doc/en/handbook/unicode/hdbk-start.docbook b/doc/en/handbook/unicode/hdbk-start.docbook new file mode 100644 index 0000000..525fb07 --- /dev/null +++ b/doc/en/handbook/unicode/hdbk-start.docbook @@ -0,0 +1,93 @@ +<chapter id="hdbk-term"><title>Starting &bibletime;</title> + +<sect1 id="hdbk-start"><title>How to start &bibletime;</title> + + <sect2 id="hdbk-start-kde"><title>Starting &bibletime; from KDE</title> + + <para> &bibletime; is a &kde; program and is integrated with the &kde; desktop. + You can launch &bibletime; from the &kde; Start Menu in + the Applications group with this icon: + <mediaobject> + <imageobject><imagedata fileref="i_bibletime.png" format="PNG"/></imageobject> + <textobject> + <phrase>&bibletime; start icon</phrase> </textobject> + </mediaobject> + </para> + + <para>&bibletime; can also be launched from a terminal command prompt. + To launch &bibletime;, open a terminal window and type: +<screen> +bibletime +</screen> + </para> + + </sect2> + + <sect2 id="hdbk-start-otherwm"><title>Other window managers</title> + + <para>&bibletime; can be used with other window managers such as Gnome, BlackBox or Sawfish, + providing &kde; is already installed on your computer. If your &kde; is installed + in /opt/kde, then the start-up command in a terminal would be:</para> + +<screen> +export TDEDIR=/opt/kde #your KDE directory +bibletime +</screen> + + </sect2> + + <sect2 id="hdbk-start-custom"><title>Startup customization</title> + + <para>From a terminal you can use &bibletime; to open a random verse in the + default bible: +<screen> +bibletime --open-default-bible "<random>" +</screen> + To open at a given passage like John 3:16, use: +<screen> +bibletime --open-default-bible "John 3:16" +</screen> + You can also use booknames in your current bookname language. + </para> + + </sect2> + +</sect1> + +<sect1 id="hdbk-startsequence"><title>Startup sequence</title> + + <para>As &bibletime; launches you may see the following screens before + the main &bibletime; window opens:</para> + + <variablelist> + + <varlistentry> + <term><interface>Bookshelf Manager</interface></term> + <listitem><para><action>Modifies your Bookshelf.</action> This dialog + lets you modify your Bookshelf, add or delete works from your system. + It will only be shown if no default Bookshelf can be found. Please see + <link linkend="hdbk-op-bookshelfmanager">this section</link>for further details. + If you start off with an empty Bookshelf, it will be helpful to install at least one Bible, + Commentary, Lexicon and one Book to get to know &bibletime;'s basic features quickly.</para></listitem> + </varlistentry> + + <varlistentry> + <term><interface>Configure &bibletime; dialog</interface></term> + <listitem><para><action>Customizes &bibletime;.</action> This dialog lets you + adapt &bibletime; to your needs. Please see <link linkend="hdbk-config-bt"> + the detailed description</link> of this dialog.</para></listitem> + </varlistentry> + + <varlistentry> + <term><interface>Tip of the Day</interface></term> + <listitem><para>These nifty little tips give you helpful hints for working + more efficiently with &bibletime;, and also a few quotations from the Bible. + </para></listitem> + </varlistentry> + + </variablelist> + +</sect1> + +</chapter> + diff --git a/doc/en/handbook/unicode/index.docbook b/doc/en/handbook/unicode/index.docbook new file mode 100644 index 0000000..a0c5d07 --- /dev/null +++ b/doc/en/handbook/unicode/index.docbook @@ -0,0 +1,80 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY bibletime '<application>BibleTime</application>'> + <!ENTITY sword '<application>Sword</application>'> + <!--<!ENTITY % addindex "IGNORE"> --> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + + <!-- user entities --> + <!ENTITY hdbkchap1 SYSTEM "hdbk-intro.docbook"> + <!ENTITY hdbkchap2 SYSTEM "hdbk-start.docbook"> + <!ENTITY hdbkchap3 SYSTEM "hdbk-operation.docbook"> + <!ENTITY hdbkchap4 SYSTEM "hdbk-config.docbook"> + <!ENTITY hdbkchap5 SYSTEM "hdbk-reference.docbook"> + +]> + + +<book lang="&language;"> + +<bookinfo> +<title>The &bibletime; handbook</title> + +<authorgroup> + +<author> +<firstname>Fred</firstname> +<surname>Saalbach</surname> +</author> + +<author> +<firstname>Jeffrey</firstname> +<surname>Hoyt</surname> +</author> + +<author> +<firstname>Martin</firstname> +<surname>Gruner</surname> +</author> + +</authorgroup> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> + +<copyright> + <year>1999-2005</year> + <holder>the &bibletime; team</holder> +</copyright> + +<legalnotice> + <para> + The &bibletime; handbook is part of &bibletime;. + </para> +</legalnotice> + +<date>2005-07</date> +<releaseinfo>1.5</releaseinfo> + +<abstract> +<para> + &bibletime; is a powerful Bible study tool for &kde;. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>bibletime</keyword> +<keyword>sword</keyword> +<keyword>crosswire</keyword> +<keyword>help dialog</keyword> +</keywordset> + +</bookinfo> + +&hdbkchap1; +&hdbkchap2; +&hdbkchap3; +&hdbkchap4; +&hdbkchap5; + +</book> diff --git a/doc/en/howto/CMakeL10n.txt b/doc/en/howto/CMakeL10n.txt new file mode 100644 index 0000000..b585ce4 --- /dev/null +++ b/doc/en/howto/CMakeL10n.txt @@ -0,0 +1,3 @@ +##### create translation templates ############## + +tde_l10n_auto_add_subdirectories( ) diff --git a/doc/en/howto/CMakeLists.txt b/doc/en/howto/CMakeLists.txt new file mode 100644 index 0000000..9890284 --- /dev/null +++ b/doc/en/howto/CMakeLists.txt @@ -0,0 +1,2 @@ + +add_subdirectory( unicode ) diff --git a/doc/en/howto/Makefile.am b/doc/en/howto/Makefile.am new file mode 100644 index 0000000..c4da710 --- /dev/null +++ b/doc/en/howto/Makefile.am @@ -0,0 +1,17 @@ +# this Makefile.am was automatically generated by bibletime/maintenance/gen_am.sh +# please do not edit this file but rather run the script to update + + +SUBDIRS = unicode html + + +html-files: + if test -e unicode/index.docbook; then \ + olddir=$$PWD; \ + cd html;\ + echo "Validating the XML files..."; \ + if meinproc ../unicode/index.docbook; then\ + echo "HTML files created successfully."; \ + fi; cd $$olddir; \ + fi; + diff --git a/doc/en/howto/html/Makefile.am b/doc/en/howto/html/Makefile.am new file mode 100644 index 0000000..6854ff2 --- /dev/null +++ b/doc/en/howto/html/Makefile.am @@ -0,0 +1,13 @@ +# this Makefile.am was automatically generated by bibletime/maintenance/gen_am.sh +# please do not edit this file but rather run the script to update + + +KDE_OPTIONS = noautodist +EXTRA_DIST = + + +install-data-local: + mkdir -p $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/; + chmod -R a+r+X $(DESTDIR)$(kde_htmldir)/en/bibletime; + +uninstall-local: diff --git a/doc/en/howto/unicode/CMakeL10n.txt b/doc/en/howto/unicode/CMakeL10n.txt new file mode 100644 index 0000000..4dfa67b --- /dev/null +++ b/doc/en/howto/unicode/CMakeL10n.txt @@ -0,0 +1,14 @@ +##### create translation templates ############## + +file( GLOB _docs + RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} + ${CMAKE_CURRENT_SOURCE_DIR}/*.docbook +) +list( SORT _docs ) +list( REMOVE_ITEM _docs "index.docbook" ) +list( INSERT _docs 0 "index.docbook" ) + +tde_l10n_create_template( + CATALOG "howto" + SOURCES ${_docs} +) diff --git a/doc/en/howto/unicode/CMakeLists.txt b/doc/en/howto/unicode/CMakeLists.txt new file mode 100644 index 0000000..f6c9bce --- /dev/null +++ b/doc/en/howto/unicode/CMakeLists.txt @@ -0,0 +1,7 @@ + +file( GLOB howto_text *.docbook ) + +install( + FILES ${howto_text} + DESTINATION ${HTML_INSTALL_DIR}/en/${PROJECT_NAME}/howto +) diff --git a/doc/en/howto/unicode/Makefile.am b/doc/en/howto/unicode/Makefile.am new file mode 100644 index 0000000..1a39c03 --- /dev/null +++ b/doc/en/howto/unicode/Makefile.am @@ -0,0 +1,25 @@ +# this Makefile.am was automatically generated by bibletime/maintenance/gen_am.sh +# please do not edit this file but rather run the script to update + + +KDE_OPTIONS = noautodist +EXTRA_DIST = how2-basics.docbook how2-importance.docbook how2-interpretation.docbook index.docbook + + +install-data-local: + mkdir -p $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/; + chmod -R a+r+X $(DESTDIR)$(kde_htmldir)/en/bibletime; + $(INSTALL_DATA) $(srcdir)/how2-basics.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/howto; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/how2-basics.docbook; + $(INSTALL_DATA) $(srcdir)/how2-importance.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/howto; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/how2-importance.docbook; + $(INSTALL_DATA) $(srcdir)/how2-interpretation.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/howto; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/how2-interpretation.docbook; + $(INSTALL_DATA) $(srcdir)/index.docbook $(DESTDIR)$(kde_htmldir)/en/bibletime/howto; + chmod a+r $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/index.docbook; + +uninstall-local: + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/how2-basics.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/how2-importance.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/how2-interpretation.docbook; + rm -f $(DESTDIR)$(kde_htmldir)/en/bibletime/howto/index.docbook; diff --git a/doc/en/howto/unicode/how2-basics.docbook b/doc/en/howto/unicode/how2-basics.docbook new file mode 100644 index 0000000..f70bf81 --- /dev/null +++ b/doc/en/howto/unicode/how2-basics.docbook @@ -0,0 +1,198 @@ +<chapter id="h2-basics"><title>Bible Study Basics</title> + +<sect1 id="h2-basics-purpose"> +<title>Our Purpose as we Approach the Bible</title> +<para> +<blockquote><attribution>Jn.5:39-40</attribution> <para>You search the Scriptures, because you think that +in them you have eternal life; and it is these that bear witness of Me; and you +are unwilling to come to Me, that you may have life.</para> +</blockquote> +</para> + +<para>The chief purpose of the book is to bring us to the Person. Martin Luther +said <quote>we go to the cradle only for the sake of the baby</quote>; just so +in Bible study, we do it not for its own sake but for fellowship with God. +</para> + +<blockquote><attribution>John R.W. Stott, <emphasis>Christ the +Controversialist</emphasis>, InterVarsity Press 1978, pp.97, 104.</attribution> +<para>The Jews to whom Jesus spoke [...] imagined that to possess Scripture was +tantamount to possessing life. Hillel used to say, "He who has gotten to +himself words of Torah has gotten to himself the life of the world to +come." Their study was an end in itself. In this they were grievously +deceived. [...]</para> +<para>There is neither merit nor profit in the reading of +Scripture for its own sake, but only if it effectively introduces us to Jesus +Christ. Whenever the Bible is read, what is needed is an eager expectation that +through it we may meet Christ.</para> +</blockquote> +</sect1> + +<sect1 id="h2-basics-approaches"><title>Approaches to God's Word</title> +<para>Hearing and reading provide a telescopic view of the scripture while study +and memorization provide a microscopic view of scripture. Meditating on the +scriptures brings hearing, reading, studying and memorization together and +cements the word in our minds.</para> + +<sect2 id="h2-basics-approaches-hear"><title>Hear</title> +<para>Lk.11:28 <quote>blessed are those who hear the word of God, and +observe it.</quote></para> +</sect2> + +<sect2 id="h2-basics-approaches-read"><title>Read</title> +<para>Rev.1:3 <quote>Blessed is he who reads and those who hear the words of this +prophecy [...]</quote></para> +<para>1 Tim.4:13 <quote>give attention to the public reading of Scripture [...]</quote> +</para> +</sect2> + +<sect2 id="h2-basics-approaches-study"><title>Study</title> +<para>Acts 17:11 <quote>Now these were more noble-minded than those in +Thessalonica, for they received the word with great eagerness, examining the +Scriptures daily, to see whether these things were so.</quote> +</para> +<para>2 Tim.2:15 <quote>Be diligent [KJV `Study'] to present yourself +approved to God as a workman who does not need to be ashamed, handling +accurately the word of truth.</quote></para> +</sect2> + +<sect2 id="h2-basics-approaches-memorize"><title>Memorize</title> +<para>Ps.119:11 <quote>Thy word I have hid in my heart, that I may not +sin against Thee.</quote></para> +</sect2> + +<sect2 id="h2-basics-approaches-meditate"><title>Meditate</title> +<para>Ps.1:2-3 <quote>But his delight is in the law of the Lord, And +in His law he meditates day and night. And he will be like a tree firmly planted +by streams of water, Which yields its fruit in its season, And its leaf does not +wither; And in whatever he does, he prospers.</quote> +</para> + +<para>The Navigators illustrate this by saying that as the thumb can touch all +the fingers, we can meditate on the Word as we do any of the first four. +Meditation is a key to revelation. A new Christian needs to hear and read the +Bible more than they need to study and memorize it. This is so that they become +familiar with the overall message of the Bible.</para> +</sect2> +</sect1> + +<sect1 id="h2-basics-types"><title>Types of Bible Studies</title> +<sect2 id="basics-types-topical"><title>Topical Study</title> +<para>Pick out a certain topic and follow it through, using cross-references or a +concordance.</para> +</sect2> + +<sect2 id="h2-basics-types-character"><title>Character Study</title> +<para>Studying the life of a Bible character, e.g. Joseph's life in +Gen.37-50.</para> +</sect2> + +<sect2 id="basics-types-expository"><title>Expository Study</title> +<para>Studying a certain passage: paragraph, chapter, or book.</para> +</sect2> +</sect1> + +<sect1 id="h2-basics-interpretation"><title>Basics of Correct Interpretation</title> + +<sect2 id="h2-basics-interpretation-content"><title>Content</title> +<para>What does it say? What does it say in the original language? Be careful +with definitions. Don't read into it what it doesn't say.</para> +</sect2> + +<sect2 id="h2-basics-interpretation-context"><title>Context</title> +<para>What do the verses around it say? "Context is king" is the rule -- the passage must make +sense within the structure of the entire passage and book.</para> +</sect2> + +<sect2 id="h2-basics-interpretation-cross"><title>Cross-reference</title> +<para>What do other verses about this subject say through the rest of the Bible? God +doesn't contradict Himself, so our interpretation needs to stand the test of other scriptures.</para> +</sect2> +</sect1> + +<sect1 id="h2-basics-expository"><title>An Expository Study of Matthew 6:1-18</title> +<para>Let's study together Mt.6:1-18. Read it to yourself, first looking for the key verse, the verse that sums +up the whole passage. Think you have it? Test it by picking different places in the passage and asking yourself +if they relate to the thought of the key verse. Once you find it, write it as Roman numeral One of your outline:</para> + +<orderedlist numeration="upperroman"> + <listitem><para>Beware of practicing your righteousness before men to be noticed</para></listitem> +</orderedlist> + +<para>What does <quote>practicing your righteousness</quote> mean? Does the passage give any examples? What area +of our lives is being addressed? <emphasis>Our motives!</emphasis> What sub-headings develop this thought?</para> + +<orderedlist numeration="upperalpha"> + <listitem><para>When you give</para></listitem> + <listitem><para>When you fast</para></listitem> + <listitem><para>When you pray</para></listitem> +</orderedlist> + +<para>Now fill in the outline with specific instructions of how to avoid wrong ways of practicing our +righteousness:</para> + +<orderedlist numeration="upperalpha"> + <listitem><para>When you give + <orderedlist numeration="loweralpha"> + <listitem><para>don't sound a trumpet. (how might someone <quote>sound a trumpet</quote> today?)</para></listitem> + <listitem><para>do it secretly.</para></listitem> + <listitem><para>etc.</para></listitem> + </orderedlist></para> + </listitem> +</orderedlist> +</sect1> + +<sect1 id="h2-basics-worksheet"><title>Worksheet: How to Use a Concordance</title> + +<sect2 id="h2-basics-worksheet-select"><title>To Find a Particular Verse</title> +<orderedlist numeration="arabic"> + <listitem><para>Pick out a key word or most-unusual word of the verse.</para></listitem> + <listitem><para>Turn to this word alphabetically.</para></listitem> + <listitem><para>Go down the column of listings until you find your verse.</para></listitem> +</orderedlist> + +<para>Find these verses: +<orderedlist numeration="arabic"> + <listitem><para><quote>Faithful are the wounds of a friend</quote></para></listitem> + <listitem><para><quote>We are ambassadors of Christ.</quote></para></listitem> + <listitem><para>The story of the rich man and Lazarus.</para></listitem> +</orderedlist> +</para> +</sect2> + +<sect2 id="h2-basics-worksheet-study"><title>To Do a Topical Study </title> +<para>Let's say you wanted to do a study of the word "redemption." First you would look up that word in the +concordance and look up references listed for it. Then you could look up related words and references listed for them, e.g. +"redeem, redeemed, ransom," even "buy" or "bought." </para> +</sect2> + + +<sect2 id="h2-basics-worksheet-clarify"><title>To Clarify Word Meanings in the Greek and Hebrew</title> +<para>What if you noticed a contradiction in the KJV between Mt.7:1 <quote>Judge not lest you be judged</quote> and 1 Cor.2:15 +<quote>He that is spiritual judgeth all things.</quote> Maybe there are two different Greek words here, both being translated "judge" in +English? (We're using Strong's from here out.) </para> +<orderedlist numeration="arabic"> + <listitem><para>Look up "judge".</para></listitem> + <listitem><para>Go down the column of entries to Mt.7:1. To the right is a number, 2919. This refers to the Greek word used. + Write it down.</para></listitem> + <listitem><para>Now look up "judgeth".</para></listitem> + <listitem><para>Go down the column to 1 Cor.2:15 . . . . . 350.</para></listitem> + <listitem><para>Turn in the back to the Greek dictionary. (Remember, you're in the NT so the language is Greek, while the + OT is Hebrew.) Compare the meaning of 2919 with the meaning of 350 and you have your answer! </para></listitem> +</orderedlist> +</sect2> + +<sect2 id="h2-basics-worksheet-names"><title>To Find Meanings of Names</title> +<para>By the same process we can find the meaning of a name in the Greek or Hebrew.</para> +<para>Look up these names and write down their meaning:</para> +<itemizedlist> +<listitem><para>Nabal</para></listitem> +<listitem><para>Abigail</para></listitem> +<listitem><para>Joshua</para></listitem> +<listitem><para>Barnabus</para></listitem> +</itemizedlist> +</sect2> + +</sect1> + +</chapter> diff --git a/doc/en/howto/unicode/how2-importance.docbook b/doc/en/howto/unicode/how2-importance.docbook new file mode 100644 index 0000000..8464528 --- /dev/null +++ b/doc/en/howto/unicode/how2-importance.docbook @@ -0,0 +1,311 @@ +<chapter id="h2-importance"><title>Importance of God's Word</title> +<para>Understanding God's word is of great importance to all who call on +God's name. Study of the Bible is one of the primary ways that we learn to +communicate with God.</para> + +<sect1 id="h2-importance-unique"><title>A Book that is Unique</title> +<para>The Bible stands alone in many ways. It is unique in:</para> + +<itemizedlist> +<listitem> +<para> +popularity. Bible sales in North America: more than $500 million per +year. The Bible is both the the all-time and year-to-year best seller! +</para> +</listitem> +<listitem> +<para> +authorship. It was written over a period of 1600 years by 40 different +authors from different backgrounds, yet reads as if written by one. +</para> +</listitem> +<listitem> +<para> +preservation. F. F. Bruce in <emphasis>Are New Testament Documents Reliable?</emphasis> +compares New Testament manuscripts with other ancient texts: +</para> +</listitem> +</itemizedlist> +<table> +<title>Comparison of New Testament manuscripts with other ancient texts.</title> +<tgroup cols="5"> +<thead> +<row> +<entry>Work</entry> +<entry>When Written</entry> +<entry>Earliest Copy</entry> +<entry>Time Lapse</entry><entry>Number of Copies</entry> +</row></thead> +<tbody> +<row> +<entry>Herodotus</entry> +<entry>448-428 B.C.</entry><entry>900 A.D.</entry> +<entry>1300 years</entry><entry>8 +</entry></row> +<row> +<entry>Tacitus</entry> +<entry>100 A.D.</entry><entry>1100 A.D.</entry> +<entry>1000 years</entry><entry>20 +</entry></row> +<row> +<entry>Caesar's <emphasis>Gallic War</emphasis></entry> +<entry>50-58 B.C.</entry><entry>900 A.D.</entry> +<entry>950 years</entry><entry>10 +</entry></row> +<row> +<entry>Livy's <emphasis>Roman History</emphasis></entry> +<entry>59 B.C. - 17 A.D.</entry><entry>900 A.D.</entry> +<entry>900 years</entry><entry>20 +</entry></row> +<row> +<entry>New Testament</entry> +<entry>40 A.D. - 100 A.D.</entry><entry>130 A.D. Partial manuscripts 350 +A.D. Full manuscripts</entry> <entry>30 - 310 years</entry><entry>5000 Greek & 10,000 Latin +</entry></row> +</tbody></tgroup></table> +<para>Ten copies of Caesar's <emphasis>Gallic War</emphasis> exist, the earliest of which was copied +900 years after Caesar wrote the original, etc. For the New Testament we have +full manuscripts dating to 350 A. D., papyri containing most of the New +Testament from the 200s, and a fragment of John's gospel from 130 A. D. How +many manuscripts do we have to compare to each other? 5,000 in Greek and 10,000 +in Latin! </para> +<blockquote><attribution>Textual critic F. J. A. Hort, "The New Testament in the +Original Greek", vol. 1 p561, Macmillan Co., quoted in <emphasis>Questions of Life</emphasis> p. +25-26</attribution><para>"In the verity and fullness of the evidence on which +it rests, the text of the New Testament stands absolutely and unapproachably +alone among other ancient prose writings." </para></blockquote> +</sect1> + +<sect1 id="h2-importance-breathed"><title>A Book that God Breathed</title> +<para><emphasis>Heb.4:12 </emphasis>"<emphasis>For the word of God is living and active... +</emphasis>" Jesus said <emphasis>(Mt.4:4),</emphasis> +"<emphasis>It is written, Man shall not live on bread alone, but on every word that +proceeds [lit., is proceeding] from the mouth of God.</emphasis>" +As we read the Bible, God's Spirit is there to speak it to our hearts in a continually-fresh way. +</para> +<para>2 Tim.3:16 declares, "<emphasis>All scripture is inspired by God [lit., +God-breathed].</emphasis>" Do you believe this? Before you answer, consider Jesus' attitude +toward the Scriptures. </para> +<blockquote><attribution>John R.W. Stott, <emphasis>Christ the Controversialist</emphasis>, +InterVarsity Press 1978, pp.93-95 </attribution><para>He referred to the human authors, but took it for +granted that behind them all was a single divine Author. He could equally say +'Moses said' or 'God said' (Mk.7:10). He could quote a comment of the narrator in +Genesis 2:24 as an utterance of the Creator Himself (Mt.19:4-5). Similarly He +said, 'Well did Isaiah prophesy of you hypocrites, as it is written', when what He +went on to quote is the direct speech of the Lord God (Mk.7:6 & Is.29:13). It +is from Jesus Himself that the New Testament authors have gained their +conviction of the dual authorship of Scripture. For them it was just as true to +say that 'God spoke of old to our fathers by the prophets' (Heb.1:1) as it was to +say that 'men moved by the Holy Spirit spoke from God' (2 Pe.1:21). God did not +speak in such a way as to obliterate the personality of the human authors, nor +did men speak in such a way as to corrupt the Word of the divine Author. God +spoke. Men spoke. Neither truth must be allowed to detract from the other. ... +</para> +<para> +This, then, was Christ's view of the Scriptures. Their witness was God's +witness. The testimony of the Bible is the testimony of God. And the chief +reason why the Christian believes in the divine origin of the Bible is that +Jesus Christ Himself taught it. </para></blockquote> + +<para>2 Tim.3:16 goes on, "<emphasis>and profitable for teaching, for +correction, for training in righteousness, that the man of God may be adequate, +equipped for every good work.</emphasis>" If we accept that the Bible really is God +speaking to us, it follows that it will be our authority in all matters of faith +and conduct. </para> +</sect1> + +<sect1 id="h2-importance-works"><title>A Book that Works</title> +<para> +What will studying the Bible do for you? 1 Thess.2:13 says that the Bible +"<emphasis>performs its work in you +who believe.</emphasis>" Beside each scripture, write down the work the Word +performs. +</para> +<table> +<title>What does Bible study do for Christians?</title> +<tgroup cols="2"> +<thead> +<row> +<entry>Reference</entry> +<entry>Action</entry> +</row> +</thead> +<tbody> +<row> +<entry>Eph. 5:26 +</entry> +<entry>cleanses -- "...having cleansed her by the washing of water with the word." +</entry> +</row> +<row> +<entry> +Acts 20:32 +</entry> +<entry> +builds up -- +" +...the word of His grace, which is able to build you up and to give you the +inheritance among all those who are sanctified. +" +</entry> +</row> +<row> +<entry> +Rom. 15:4 +</entry> +<entry> +encourages -- "that through perseverance and the +encouragement of the Scriptures we might have hope." +</entry> +</row> + +<row> +<entry> +Rom. 10:17 +</entry> +<entry> +gives faith -- +"So faith comes from hearing, and hearing by the word of +Christ." +</entry> +</row> + +<row> +<entry> +1 Cor. 10:11 +</entry> +<entry> +instructs -- +"Now these things happened to them for an example, +and they were written for our instruction" +</entry> +</row> + +<row> +<entry> +Mt. 4:4 +</entry> +<entry> +nourishment -- +"But He answered and said, 'It is written, Man shall not live on bread alone, +but on every word that proceeds out of the +mouth of God.'" +</entry> +</row> +</tbody> +</tgroup> +</table> +</sect1> + +<sect1 id="h2-importance-liberates"><title>A Book that Liberates</title> +<para> +Jn.8:32 "<emphasis>and you shall know the truth, and the truth shall make you +free.</emphasis>"This is usually quoted by +itself. Is this a conditional or unconditional promise? Would it apply to +all kinds of knowledge? Find the answers by examining the first half of the +sentence, in v.31. "<emphasis>If you abide in My word, then you are truly disciples of +Mine... </emphasis>"</para> +<para>We see that this is a conditional promice, specifically speaking of the truth of God's word.</para> + +<para>The Greek word for "wind" used in Eph.4:14 means a <emphasis>violent wind.</emphasis> +"<emphasis>As a result, we are no longer to be children, tossed here and there by +waves, and carried about by every wind of doctrine...</emphasis>"One +thing studying the Bible does for us is to ground us in the truth, with the +result that we won't be easily "blown away."</para> + +<para><emphasis>But Jesus answered and said to them, </emphasis>"<emphasis>You are mistaken [KJV Ye do err], not +understanding the Scriptures, or the power of God.</emphasis>"Mt.22:29</para> +<para>What 2 things do we need to know to be kept from error?</para> +<itemizedlist> +<listitem><para>God's word</para></listitem> +<listitem><para>God's power </para></listitem> +</itemizedlist> +</sect1> + +<sect1 id="h2-importance-wars"><title>A Book that Wars</title> +<para> +Eph.6:10-18 is one picture of our spiritual armament.</para> +<table> +<title>Spiritual Armor</title> +<tgroup cols="2"> +<thead> +<row> +<entry>Question</entry> +<entry>Answer</entry> +</row></thead> +<tbody> +<row><entry>How many of the weapons listed here are defensive weapons?</entry><entry>5</entry></row> +<row><entry>How many are offensive?</entry><entry>One</entry></row> +<row><entry>Which one(s)? </entry><entry>the word - <foreignphrase>rhema</foreignphrase></entry></row> +</tbody></tgroup></table> +</sect1> + +<sect1 id="h2-importance-exhortations"><title>Exhortations</title> +<para> +2 Tim.2:15 (KJV) "<emphasis>Study to show thyself approved unto God, a workman that needeth not to be ashamed, rightly +dividing the word of truth.</emphasis>" +</para> +<para> +Col.3:16 "<emphasis>Let the word of Christ richly dwell within you; with all wisdom teaching and admonishing one another +with psalms and hymns and spiritual songs, singing with thankfulness in your hearts to God.</emphasis>" +</para> + +<para>If you're rich in something, how much of it do you +have? </para> +<para> +Not a little!</para> + +<para> +Eccl.12:11-12 "<emphasis>The words of wise men are like goads, and masters of these +collections are like well-driven nails; they are given by one Shepherd. But +beyond this, my son, be warned: the writing of many books is endless, and +excessive devotion to books is wearying to the body.</emphasis>" +</para> </sect1> + +<sect1 id="h2-importance-once"><title>Appendix: "Once for +All"</title> +<blockquote> +<attribution>John R. W. Stott, <emphasis>Christ the Controversialist,</emphasis> +InterVarsity Press 1978, pp.106-107</attribution> <para>The truth regarding the +finality of God's initiative in Christ is conveyed by one word of the Greek +Testament, namely the adverb <foreignphrase>hapax</foreignphrase> and +<foreignphrase>ephapax</foreignphrase>. It is usually translated in the +Authorized Version once, meaning once for all. It is used of what is so done as +to be of perpetual validity and never need repetition, and is applied in the NT +to both revelation and redemption. Thus, Jude refers to the faith which was +once for all delivered to the saints (Jude 3), and Romans says, +"<emphasis>Christ also died for sins once for all</emphasis>" +(Rom.6:10, see also 1 Pe.3:18; Heb.9:26-28). </para> <para> +Thus we may say that God has spoken once +for all and Christ has suffered once for all. This means that the Christian +revelation and the Christian redemption are both alike in Christ complete. +Nothing can be added to either without being derogatory to Christ... These are +the two rocks on which the Protestant Reformation was built -- Gods revealed +word without the addition of human traditions and Christ's finished work without +the addition of human merits. The Reformers great watchwords were <foreignphrase>sola +scriptura</foreignphrase> for our authority and <foreignphrase>sola gratia</foreignphrase> for our salvation.</para> +</blockquote> +</sect1> + +<sect1 id="h2-importance-supplement"><title>Supplement: Bible Reading +Programs</title> <para> Here are some easy programs to systematically read your +Bible. You can do more than one at a time if you like, for instance #1 with #4, +or #2 with #5. Vary the program from year to year to keep it fresh! +</para> +<orderedlist numeration="arabic"> +<listitem><para>New Testament in a Year: read one chapter each day, 5 days a +week.</para></listitem> +<listitem><para>Proverbs in a Month: read one chapter of Proverbs each day, +corresponding to the day of the month.</para></listitem> +<listitem><para>Psalms in a Month: read 5 Psalms at intervals of 30 each day, +for instance on the 20th you read Ps.20, 50, 80, 110, & 140.</para></listitem> +<listitem><para>Psalms & Proverbs in 6 months: read through Psalms and Proverbs +one chapter per day.</para></listitem> +<listitem><para>Old Testament without Psalms & Proverbs in 2 years: if +you read one chapter a day of the Old Testament, skipping over Psalms & Proverbs, you will read the Old Testament in 2 years and 2 weeks. +</para></listitem> +</orderedlist> +</sect1> + +</chapter> + diff --git a/doc/en/howto/unicode/how2-interpretation.docbook b/doc/en/howto/unicode/how2-interpretation.docbook new file mode 100644 index 0000000..aadc189 --- /dev/null +++ b/doc/en/howto/unicode/how2-interpretation.docbook @@ -0,0 +1,212 @@ +<chapter id="h2-rules"><title>Rules of Bible Interpretation (Hermeneutics)</title> +<para>We already learned about the "3 Cs": content, context, cross-reference. We want to expand that now by +delving briefly into biblical hermeneutics, whose goal is to discover the meaning intended by the original author (and +Author!). While many applications of a passage are valid, only one interpretation is valid. The scripture itself says +this by saying that no scripture is of any private interpretation (2 Pe.1:20 KJV <quote>Knowing this first, that no +prophesy of scripture is of any private interpretation.</quote>). Certain rules are helps toward discovering the correct meaning; +by ignoring these rules people have brought much trouble on themselves and their followers. 2 Pe.3:16 <quote>...in which are +some things hard to understand, which the untaught and unstable distort, as they do also the rest of the Scriptures, to +their own destruction.</quote></para> + +<para>How do we go about discovering the intended meaning of a passage? Let's say your attention has been +drawn to a particular verse whose meaning is not clear to you. How do you study it out? Keep these rules in mind:</para> + +<section id="h2-rules-exact"><title>Rule 1 - Interpret according to the exact meaning of the words.</title> +<para>The more precise we can be with the exact, original meaning of the words the better our interpretation will be. +Try to find the exact meaning of the key words by following these steps:</para> + +<orderedlist> + <listitem> + <formalpara><title>Definition</title> + <para>Look up the definition in a Greek or Hebrew dictionary. For verbs, the verb tense is also crucial.</para> + </formalpara> + </listitem> + + <listitem> + <formalpara><title>Cross-reference</title> + <para>Compare scripture with scripture. Seeing how the same Greek or Hebrew word + (not the English word) is used in scripture may clarify or throw new light on the definition. How does the same author + use this word elsewhere? Other authors? Your reference tools may give you uses of the word in non-biblical + documents, as well. Why do we have to go to the original languages; why isn't the English word good enough? + <emphasis>Because more than one greek word may be translated into the same english word, and the greek + words may have different shades of meaning.</emphasis></para> + </formalpara> + </listitem> +</orderedlist> + +<section id="h2-rules-exact-crossref-ex1a"><title>Example 1A</title> +<para>Jn.20:17 <emphasis>"Touch me not"</emphasis> (KJV) sounds harsh, doesn't it? Sounds like Jesus doesn't want +to be touched now that He is risen, that He is too holy or something. But that doesn't seem right, so let's look +it up in Spiros Zodhiates' <emphasis>The Complete Word Study New Testament</emphasis> (AMG Publishers, 1991).</para> + +<para>Definition: Turning to John 20:17, above the word "Touch" we see "pim680." The letters +give us a code for the part of speech, and the number refers to Strong's dictionary reference. Let's look up +the definition (p. 879). "680. Haptomai; from hapto (681), touch. Refers to such handling of an object as to exert a modifying +influence upon it... Distinguished from pselaphao (5584), which actually only means to touch the surface of something. " Now look +up "pim." The grammar codes in Zodhiates come right after Revelation; on p. 849 we see that pim stands for +"present imperative active (80)". On p.857, "Present Imperative. In the active voice, it may indicate a command to do +something in the future which involves continuous or repeated action or, when it is negated, a command to stop doing something. " This +is a negative command, so it is to stop doing something that is already occuring. So, what have we found?</para> +<para><emphasis>Mary is already clinging to Jesus, and he is saying to stop holding him!</emphasis></para> +</section> + +<section id="h2-rules-exact-crossref-ex1b"><title>Example 1B</title> +<para>In James 5:14, <emphasis>Elders are told to pray and anoint someone who is sick</emphasis>. What is this anointing?</para> +<para>Definition of aleipho (218) - "to oil" (Strong's); but we also have another Greek word translated +"anoint", chrio (5548) - "to smear or rub with oil, i.e. to consecrate to an office or religious service" (Strong's). + Since it's a verb, consider the tense also, "apta" aorist participle active. "The aorist participle expresses simple action, +as opposed to continuous action...When its relaitonship to the main verb is temporal, it usually signifies action prior to that of the main +verb." (Zodhiates p.851)</para> + +<itemizedlist> +<listitem><para>Cross-references for aleipho: + <orderedlist> + <listitem><para>Mt.6:17 But you, when you fast, anoint your head</para></listitem> + <listitem><para>Mk.16:1 [the women] brought spices that they might come and anoint Him.</para></listitem> + <listitem><para>Mk.6:13 And they were...anointing with oil many sick people and healing them.</para></listitem> + <listitem><para>Lk.7:38 [...] kissing His feet and anointing them with the perfume</para></listitem> + <listitem><para>Jn.12:3 Mary [...] anointed the feet of Jesus, and wiped them with her hair</para></listitem> + </orderedlist></para> +</listitem> + +<listitem><para>Cross-references of chrio: + <orderedlist> + <listitem><para>Lk.4:18 <quote>The Spirit of the Lord is upon me, because He has anointed me to preach [...]</quote></para></listitem> + <listitem><para>Acts 4:27 Jesus, whom Thou hast anointed</para></listitem> + <listitem><para>Acts 10:38 God anointed Jesus with the Holy Ghost and power</para></listitem> + <listitem><para>2 Cor.1:21 Now He who...anointed us is God</para></listitem> + </orderedlist></para> +</listitem> +</itemizedlist> + +<para>So what's the difference between aleipho and chrio? Look back over the cross-references and the +definitions, and sum up the difference: <emphasis>"aleipho" is a practical use of oil and "chrio" is a spiritual</emphasis></para> + +<para>As an illustration (although the word is not used) of the practical use of oil at that time, when the good +Samaritan cared for the man beat up by robbers he poured oil and wine in the wound. So oil had a medicinal +use in Jesus' day. +</para> +<para>Now let's apply what we just learned by this word study to James 5:14 <emphasis>"Is any among you sick? Let +him call for the elders of the church; and let them pray over him, anointing him with oil in the name of the +Lord."</emphasis> Is "anointing" spiritual or practical? Practical!</para> +<para> +And the tense in Greek, the aorist participle, would +be better translated "having anointed," so the order is the anointing first, then the prayer ("in the name of the +Lord"refers to the prayer, not the anointing). James 5 is saying that the elders should give the sick person +medicine and pray for him in the name of the Lord. Doesn't that express a beautiful balance of practical and +spiritual in our God! +</para> +</section> +</section> + +<section id="h2-rules-context"> +<title>Rule 2 - Interpret within the biblical +context</title> +<para>Interpret scripture in harmony with other scripture. What do the +verses on each side say? What is the theme of the chapter? the book? Does your interpretation fit with these? If not, +it is flawed. Usually, the context supplies what we need to correctly interpret the passage. Context is key. If +confusion remains as to the meaning after we have interpreted the text within its context, we have to look further.</para> + +<section id="h2-rules-context-ex2a"><title>Example 2A</title> +<para>In a previous lesson we considered Jn.3:5 <emphasis>"born of water and the Spirit."</emphasis> In context, what is +the water under discussion here?</para> +<para>Water baptism is not under discussion here, which would be a big switch from the subject being +discussed by Jesus and Nicodemus. Watch out for a sudden change of topic, it may be a clue that your +interpretation has been derailed! The water is the amniotic fluid, "born of water" = natural birth.</para> +</section> +<section id="h2-rules-context-ex2b"><title>Example 2B</title> +<para>1 Cor.14:34 <quote>Let the women keep silent in the churches</quote> has to be taken within the biblical +context of 1 Cor.11:5 <quote>every woman [...] while praying or prophesying [...]</quote></para> +</section> +<section id="h2-rules-context-ex2c"><title>Example 2C</title> +<para>Acts 2:38 <quote>And Peter said to them, "Repent, +and let each of you be baptized in the name of +Jesus Christ for the forgiveness of your sins [...]"</quote>. Is this teaching baptismal regeneration? If this was the +only verse of scripture we had, we would have to conclude that. But in the light of the clear teaching +elsewhere that regeneration happens by faith in Christ, we have to interpret it otherwise. Peter is urging +baptism as a way for his hearers to respond to the gospel. If baptism were the pathway to being born again, +how could Paul write 1 Cor.1:17 <emphasis>"For Christ did not send me to baptize, but to preach the gospel"</emphasis>? +</para> +</section> +</section> + +<section id="h2-rules-hcontest"> +<title>Rule 3 - Interpret within the historical and cultural context</title> +<para> +At first we are not asking <quote>What does it mean to me?</quote> but <quote>What did it mean to the original readers?</quote>; later we can ask, <quote>What does it mean to me?</quote>. +We have to take into account the historical and cultural background of the author and the recipients.</para> + +<section id="h2-rules-hcontest-ex3a"><title>Example 3A</title><para> <quote>3 days & 3 nights</quote> (Mt.12:40) have +led some to come up with a "Wednesday crucifixion theory," +esp. the cult of Armstrongism. How could Jesus die on Friday afternoon and rise Sunday morning +yet "be raised on the third day" (Mt.16:21)? Exact meanings of "three" or "days" won't help explain the +apparent contradiction.</para> +<para>We need an historical tidbit: Jews counted any part of a day as a full day, as we would count buckets +of water (if there were six and one-half buckets of water, we would say there were 7 buckets of water even if one was only partly full). So to the Jewish +mind, any part of a day counted as a full day, and days started at 6 p.m. and ended at 6 p.m. Friday from 3 +p.m. to 6 p.m. = day 1. Friday 6 p.m. to Saturday 6 p.m. = day 2. Saturday 6 p.m. to Sunday 5 or so a.m. = +day 3. Interpreting within the cultural context keeps us out of trouble.</para> +</section> + +<section id="h2-rules-hcontest-ex3b"><title>Example 3B</title><para>Gen.15:7-21. The historical context +is that cutting animals in two and then walking between +the pieces was the normal way of entering a contract in Abraham's day. Both parties walked between, taking +the pledge that dismemberment would happen to them if they didn't live up to their part of the contract. But +in this case only God goes thru, making it a unilateral covenant.</para> +</section> +</section> + +<section id="h2-rules-normal"><title>Rule 4 - Interpret according to the normal usage of words in language</title> +<para>Let literal language be literal and +figurative language be figurative. And watch out for idioms, which have special meanings.</para> + +<section id="h2-rules-normal-ex4a"><title>Example 4A</title> +<para><quote>evil eye</quote> in Mt.6:23.</para> +<para>Rule 1, definition of "evil" and "eye" - no help here. Rule 2, context: seems to confuse us even +more. It doesn't seem to fit with what goes before and after! This should tip us off that we aren't +understanding it rightly!!</para> +<para>What we have here is a Hebrew idiom, <quote>evil eye</quote>. Let's look up other uses of this idiom: Mt.20:15 +"<emphasis>Is it not lawful for me to do what I wish with what is my own? Or is your eye envious [lit."evil"] because I +am generous [lit. "good"]?</emphasis>" We find that having an "evil eye" is a Hebrew idiom for being stingy or envious. +Now go back to Mt.6 and notice how this understanding ties in so perfectly to the context.</para> +</section> + +<section id="h2-rules-normal-ex4b"><title>Example 4B</title> +<para>Is.59:1 <quote>The Lord's hand is not short;</quote></para> +<para>Deut.33:27 <quote>Underneath are the everlasting arms.</quote></para> +<para> +References to body parts of God are used by Latter-Day Saints to prove that God was once a man just as we +are. Once they convince people of that, they go on to teach that we can become God just like He is! At a +lecture he was giving, a group of Mormon elders challenged Walter Martin (author of <emphasis>Kingdom of the Cults</emphasis>) +with an enumeration of verses like these. Dr. Martin then asked the Mormons to read one more scripture: +Ps.91:4 <quote>He will cover you with His feathers; And under His wings shalt thou trust</quote>. W.M. said, <quote>By the same +rules of interpretation that you just proved God to be a man, you just proved that He is a bird</quote>. The Mormons +had to laugh as they realised the ridiculousness of their position. +</para> +</section> +</section> + +<section id="h2-rules-parables"><title>Rule 5 - Understand the purpose of parables and the difference between a parable and an allegory</title> +<para>An allegory is: <emphasis>A story where each element has a meaning.</emphasis></para> +<para>Every parable is an allegory, true or false?</para> + +<para>Some parables are allegories, for instance, the parable of the sower is an allegory: the seed is the word of +God, the thorns are worries and greed, etc. But most parables are not allegories but simply stories to illustrate one +point. It's dangerous to get our doctrine from parables; they can be twisted to say all sorts of things. We need to get +our doctrine from clear scriptures that lay it out; then if a parable illustrates that, fine.</para> + +<section id="h2-rules-parables-ex5a"><title>Example 5A</title> +<para>The parable of the widow with the unrighteous judge in Lk.18:1-8. This story illustrates one +lesson: boldness in prayer. If we draw it into an allegory, what do we have?</para> +<para>All sorts of violence happens to the meanings: God is reluctant to protect the rights of widows, prayer +"bothers" Him, etc.</para></section> + +<section id="h2-rules-parables-ex5b"><title>Example 5B</title> +<para>The parable of the unrighteous steward in Lk.16:1-9. What is the point of the parable? Is it +an allegory? </para> +<para>The steward is commended for only one thing, his shrewdness in using what he had to prepare for a +time when he wouldn't have it. But he is not commended for his unethical behavior in cheating his master. </para> +</section> + +</section> +</chapter> diff --git a/doc/en/howto/unicode/index.docbook b/doc/en/howto/unicode/index.docbook new file mode 100644 index 0000000..2570dcc --- /dev/null +++ b/doc/en/howto/unicode/index.docbook @@ -0,0 +1,77 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY bibletime '<application>BibleTime</application>'> + <!ENTITY kapp "&bibletimehandbook;"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + + <!-- user entities --> + + <!ENTITY how2-chap1 SYSTEM "how2-importance.docbook"> + <!ENTITY how2-chap2 SYSTEM "how2-basics.docbook"> + <!ENTITY how2-chap3 SYSTEM "how2-interpretation.docbook"> + +]> + +<book lang="&language;"> + +<bookinfo> +<title>The Biblestudy HowTo</title> + +<authorgroup> + <author> + <firstname>Bob</firstname> + <surname>Harman</surname> + </author> + <author> + <firstname></firstname> + <surname>The BibleTime team</surname> + </author> +</authorgroup> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> + +<copyright> + <year>2001-2008</year> + <holder>The team of &bibletime; ([email protected])</holder> +</copyright> + +<legalnotice> + <para> + This document was originally created by Mr. Bob Harman and + is licensed under the terms of the license + <link url="http://creativecommons.org/licenses/by-sa/3.0/"> + "Creative Commons Attribution-Share Alike"</link>. + </para> + <para> + Scripture quotes are from the New American Standard Bible unless otherwise indicated. + </para> +</legalnotice> + +<abstract> +<title>Abstract</title> +<para> +The <application>Biblestudy HowTo</application> is a guide for studying the Bible. +</para> +<para>It is the hope of the &bibletime; team that this HowTo will provoke the +readers to study the scriptures to see what they say. This +particular study guide has been chosen as it takes care not to +advocate any particular denominational doctrine. We expect you to read +and study the scriptures to understand what they say. If you start +with the attitude that you want to have the Lord sow his word in your +heart He will not disappoint you.</para> +</abstract> + +<keywordset> +<keyword>Bible</keyword> +<keyword>Study</keyword> +<keyword>HowTo</keyword> +</keywordset> + +</bookinfo> + +&how2-chap1; +&how2-chap2; +&how2-chap3; + +</book> |
