From 7330722b2fee0e46818a0150c7ac00c56782ae65 Mon Sep 17 00:00:00 2001 From: Jillianne Presley Date: Sat, 9 Sep 2017 22:24:37 -0700 Subject: [PATCH] Docs reorg: Adding a manual for command line administrators Signed-off-by: Jane Sandberg --- docs/admin/physical_char_wizard_db.adoc | 18 +++ .../migrating_patron_data.adoc | 3 + .../migrating_your_data.adoc | 3 + docs/cataloging/physical_char_wizard.adoc | 9 -- docs/development/support_scripts.adoc | 3 +- docs/installation/server_installation.adoc | 2 +- docs/root_command_line_admin.adoc | 114 ++++++++++++++++++ 7 files changed, 140 insertions(+), 12 deletions(-) create mode 100644 docs/admin/physical_char_wizard_db.adoc create mode 100644 docs/root_command_line_admin.adoc diff --git a/docs/admin/physical_char_wizard_db.adoc b/docs/admin/physical_char_wizard_db.adoc new file mode 100644 index 0000000000..9523d78a3d --- /dev/null +++ b/docs/admin/physical_char_wizard_db.adoc @@ -0,0 +1,18 @@ +Administering the Physical Characteristics Wizard +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The MARC 007 Field Physical Characteristics Wizard enables catalogers to interact with a +database wizard that leads the user step-by-step through the MARC 007 field positions. +The wizard displays the significance of the current position and provides dropdown lists +of possible values for the various components of the MARC 007 field in a more +user-friendly way. + +The information driving the MARC 007 Field Physical Characteristics Wizard is already a +part of the Evergreen database. This data can be customized by individual sites and / or +updated when the Library of Congress dictates new values or positions in the 007 field. +There are three relevant tables where the information that drives the wizard is stored: + +. *config.marc21_physical_characteristic_type_map* contains the list of materials, or values, for the positions of the 007 field. +. *config.marc21_physical_characteristic_subfield_map* contains rows that list the meaning of the various positions in the 007 field for each Category of Material. +. *config.marc21_physical_characteristic_value_map* lists all of the values possible for all of the positions in the config.marc21_physical_characteristic_subfield_map table. + diff --git a/docs/admin_initial_setup/migrating_patron_data.adoc b/docs/admin_initial_setup/migrating_patron_data.adoc index 878c628426..dd531d43d1 100644 --- a/docs/admin_initial_setup/migrating_patron_data.adoc +++ b/docs/admin_initial_setup/migrating_patron_data.adoc @@ -1,6 +1,9 @@ Migrating Patron Data ===================== +Introduction +------------ + This section will explain the task of migrating your patron data from comma delimited files into Evergreen. It does not deal with the process of exporting from the non-Evergreen system since this process may vary depending on where you diff --git a/docs/admin_initial_setup/migrating_your_data.adoc b/docs/admin_initial_setup/migrating_your_data.adoc index e65af47b9d..8ae1725fe8 100644 --- a/docs/admin_initial_setup/migrating_your_data.adoc +++ b/docs/admin_initial_setup/migrating_your_data.adoc @@ -1,6 +1,9 @@ Migrating from a legacy system ============================== +Introduction +------------ + When you migrate to Evergreen, you generally want to migrate the bibliographic records and copy information that existed in your previous library system. For anything more than a few thousand records, you should import the data directly diff --git a/docs/cataloging/physical_char_wizard.adoc b/docs/cataloging/physical_char_wizard.adoc index 13d23d5463..d6df8b8505 100644 --- a/docs/cataloging/physical_char_wizard.adoc +++ b/docs/cataloging/physical_char_wizard.adoc @@ -46,12 +46,3 @@ Continue editing the MARC record, as needed. Once the user is finished editing t image::media/pcw6_2.12.jpg[] -*Administration* - -The information driving the MARC 007 Field Physical Characteristics Wizard is already a part of the Evergreen database. This data can be customized by individual sites and / or updated when the Library of Congress dictates new values or positions in the 007 field. -There are three relevant tables where the information that drives the wizard is stored: - -. *config.marc21_physical_characteristic_type_map* contains the list of materials, or values, for the positions of the 007 field. -. *config.marc21_physical_characteristic_subfield_map* contains rows that list the meaning of the various positions in the 007 field for each Category of Material. -. *config.marc21_physical_characteristic_value_map* lists all of the values possible for all of the positions in the config.marc21_physical_characteristic_subfield_map table. - diff --git a/docs/development/support_scripts.adoc b/docs/development/support_scripts.adoc index fe5fbaf786..7c604a02c7 100644 --- a/docs/development/support_scripts.adoc +++ b/docs/development/support_scripts.adoc @@ -137,8 +137,7 @@ indexterm:[pg_loader.pl] The major advantages of the command line approach are its speed and its convenience for system administrators who can perform bulk loads of authority records in a controlled environment. For alternate instructions, -see <<_importing_authority_records_from_the_staff_client,Importing -Authority Records from the Staff Client>>. +see the cataloging manual. . Run *marc2are.pl* against the authority records, specifying the user name, password, MARC type (USMARC or XML). Use `STDOUT` redirection to diff --git a/docs/installation/server_installation.adoc b/docs/installation/server_installation.adoc index 3d2d973347..1273865f30 100644 --- a/docs/installation/server_installation.adoc +++ b/docs/installation/server_installation.adoc @@ -135,7 +135,7 @@ make -f Open-ILS/src/extras/Makefile.install -translator make -f Open-ILS/src/extras/Makefile.install -packager ------------------------------------------------------------------------------ -Optional: Extra steps for web staff client +Extra steps for web staff client ------------------------------------------ [NOTE] diff --git a/docs/root_command_line_admin.adoc b/docs/root_command_line_admin.adoc new file mode 100644 index 0000000000..9c06e64640 --- /dev/null +++ b/docs/root_command_line_admin.adoc @@ -0,0 +1,114 @@ +Administering Evergreen through the Command Line +================================================ +Documentation Interest Group +:doctype: book +:toc: +:numbered: + +Introduction +============ + +include::shared/about_this_documentation.adoc[] + +This guide to Evergreen is designed for system administrators who can +access their Evergreen server using a command line. +It is organized into Parts, Chapters, and Sections addressing key +aspects of the software. + +Copies of this guide can be accessed in PDF and HTML formats from http://docs.evergreen-ils.org/. + + + +include::shared/about_evergreen.adoc[] + +Installing Evergreen +==================== +include::installation/system_requirements.adoc[] + +:leveloffset: 1 + +include::installation/server_installation.adoc[] + +:leveloffset: 0 + +include::installation/server_upgrade.adoc[] + +include::installation/edi_setup.adoc[] + +:leveloffset: 1 + +include::admin_initial_setup/migrating_your_data.adoc[] + +:leveloffset: 2 + +include::admin_initial_setup/migrating_patron_data.adoc[] + +:leveloffset: 0 + +Individual Evergreen Components +=============================== + +:leveloffset: 1 + +include::development/intro_opensrf.adoc[] + +include::development/pgtap.adoc[] + +:leveloffset: 0 + +include::development/support_scripts.adoc[] + +System Configuration +==================== + +:leveloffset: 1 + +include::admin_initial_setup/describing_your_people.adoc[] + +include::admin_initial_setup/describing_your_catalog.adoc[] + + +include::admin/authentication_proxy.adoc[] + +include::admin/patron_address_zip_code.adoc[] + +include::admin/apache_rewrite_tricks.adoc[] + +include::admin/apache_access_handler.adoc[] + +include::development/updating_translations_launchpad.adoc[] + +:leveloffset: 0 + + +Local Administration +==================== + +include::admin/actiontriggers.adoc[] + +Cataloging Administration +========================= + +Cataloging Staff Interface +-------------------------- + +include::admin/physical_char_wizard_db.adoc[] + +UX Administration +================= + +include::admin/template_toolkit.adoc[] + +:leveloffset: 1 + +include::admin_initial_setup/designing_your_catalog.adoc[] + +:leveloffset: 0 + +include::opac/opac/new_skin_customizations.adoc[] + + +include::shared/attributions.adoc[] + +include::shared/end_matter.adoc[] + -- 2.43.2