Merge branch 'aborkowski/koha-manual-ignore-builddir'
authorChris Cormack <chrisc@catalyst.net.nz>
Tue, 23 Jun 2020 20:32:57 +0000 (08:32 +1200)
committerChris Cormack <chrisc@catalyst.net.nz>
Tue, 23 Jun 2020 20:32:57 +0000 (08:32 +1200)
.gitlab-ci.yml
source/conf.py
source/cron_jobs.rst
source/tools.rst

index b08f816..cda6e88 100644 (file)
@@ -26,7 +26,8 @@ production:
         - build/en/html
     stage: deploy
     script:
-    - DEBIAN_FRONTEND=noninteractive apt-get install -y python3-sphinx  python3-sphinxcontrib.spelling python3-stemmer make rsync
+    - DEBIAN_FRONTEND=noninteractive apt-get install -y python3-sphinx  python3-sphinxcontrib.spelling python3-stemmer python3-pip make rsync
+    - pip3 install sphinx_rtd_theme
     - make all_epub # build/LANG/epub
     - make all_html # build/LANG/html
     - rsync -c -u -r -e "ssh" --progress build/* chrisc@www.koha-community.org:/var/www/manual/20.11/
index f3d2226..422742c 100644 (file)
@@ -19,6 +19,7 @@
 #
 # import os
 import sys; sys.setrecursionlimit(3000)
+import sphinx_rtd_theme
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
 
@@ -38,6 +39,7 @@ extensions = [
     'sphinx.ext.coverage',
     'sphinxcontrib.spelling',
     'sphinx.ext.autosectionlabel',
+    'sphinx_rtd_theme',
 ]
 
 # Spelling options
@@ -70,9 +72,9 @@ author = 'Koha Community'
 # built documents.
 #
 # The short X.Y version.
-version = '20.05'
+version = '20.11'
 # The full version, including alpha/beta/rc tags.
-release = '20.05'
+release = '20.11'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -132,13 +134,18 @@ todo_include_todos = False
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'default'
+html_theme = 'sphinx_rtd_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_theme_options = {
+
+    'prev_next_buttons_location': 'both',
+    'style_nav_header_background': '#4a9b32'
+
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
index 63e2a3c..46f1ba6 100644 (file)
@@ -219,6 +219,27 @@ Frequency suggestion: nightly
     **Note**
     Fines will not be applied on a holiday.
 
+    **PARAMETERS**
+    -  -h|--help
+       get help message
+
+    -  -l|--log
+       log the output to a file (optional if the -o parameter is given)
+
+    -  -o|--out 
+       ouput directory for logs (defaults to env or /tmp if the directory does 
+       not exist)
+
+    -  -v|--verbose
+       verbose mode
+
+    -  -m|--maxdays
+       how many days back of overdues to process
+       this can improve performance by simply the number of records that need 
+       to be processed. It can be safe to limit the overdues processed to those 
+       under X days overdues given that circulation policy often caps fines at 
+       a maximum after a number of days.
+
 .. _cron-staticfines-label:
 
 Static fines
@@ -312,6 +333,26 @@ renewal with your :ref:`circulation and fines rules <circulation-and-fines-rules
 
 Frequency suggestion: nightly
 
+    **Important**
+    To run this properly, you must use the --confirm parameter, otherwise it 
+    will only run in test mode
+
+    **PARAMETERS**
+    -  -h|--help
+       get help message
+
+    -  --send-notices
+       sends the AUTO_RENEWALS notice to patrons if the automatic renewal has 
+       been done
+
+    -  -v|--verbose
+       verbose mode
+
+    -  -c|--confirm
+       without this parameter no changes will be made, the script will run in 
+       test mode
+       without this parameter, the script will default to verbose mode as well
+
 .. _cron-patrons-label:
 
 Patrons
@@ -874,6 +915,123 @@ Script path: misc/cronjobs/cleanup\_database.pl
 Does: truncates the sessions table, cleans out old zebraqueue entries,
 action logs and staged MARC files.
 
+See http://schema.koha-community.org/ for the Koha database schema.
+
+    **PARAMETERS**
+    -  --del-exp-selfreg
+       Delete expired self registration accounts (accounts that haven't been 
+       upgraded from the 'temporary' category) from the borrowers table.
+       The number of days for expiry is set in the ref:`PatronSelfRegistrationExpireTemporaryAccountsDelay` 
+       system preference.
+       The temporary patron category is set in the ref:`PatronSelfRegistrationDefaultCategory` 
+       system preference.
+
+    -  --del-unv-selfreg DAYS 
+       Delete all unverified self registrations in borrower_modifications 
+       older than DAYS.
+
+    -  --deleted-catalog DAYS
+       Purge bibliographic records deleted more than DAYS days ago from tables 
+       deletedbiblio, deletedbiblio_metadata, deletedbiblioitems and deleteditems.
+
+    -  --deleted-patrons DAYS
+       Purge patrons deleted more than DAYS days ago from the deletedborrowers 
+       table.
+
+    -  --fees DAYS
+       Purge entries in the accountlines table older than DAYS days, where the 
+       amountoutstanding is 0 or NULL.
+       In the case of --fees, DAYS must be greater than or equal to 1.
+
+    -  -h|--help
+       Get help message
+
+    -  --import DAYS
+       Purge entries from import tables older than DAYS days.
+       This includes import_batches, import_biblios, import_items, 
+       import_record_matches and import_records. 
+       In import_batches, the batches that are the result of Z39.50 searches 
+       are removed with the --z3950 parameter.
+       Defaults to 60 days if no days specified.
+
+    -  --list-invites  DAYS
+       Purge (unaccepted) list share invites from the virtualshelfshares table 
+       older than DAYS days
+       Defaults to 14 days if no days specified.
+
+    -  --logs DAYS
+       Purge entries from the action_logs table older than DAYS days.
+       Defaults to 180 days if no days specified.
+
+    -  -m|--mail DAYS
+       Purge entries from the message_queue table that are older than DAYS days.
+       Defaults to 30 days if no days specified.
+
+    -  --merged
+       Purge completed entries from the need_merge_authorities table.
+
+    -  --oauth-tokens
+       Delete expired OAuth2 tokens
+
+    -  --old-issues DAYS
+       Purge checkouts returned more than DAYS days ago from the old_issues 
+       table.
+
+    -  --old-reserves DAYS
+       Purge holds more than DAYS old from the old_reserves table.
+
+    -  --restrictions DAYS
+       Purge patrons restrictions from the borrower_debarments table expired since more than DAYS days.
+       Defaults to 30 days if no days specified.
+
+    -  --all-restrictions
+       Purge all expired patrons restrictions from the borrower_debarments table.
+
+    -  --searchhistory DAYS
+       Purge entries from the search_history table older than DAYS days.
+       Defaults to 30 days if no days specified
+
+    -  --sessions
+       Purge the sessions table.
+       If you use this while users are logged into Koha, they will have to 
+       reconnect.
+
+    -  --sessdays DAYS
+       Purge only sessions older than DAYS days.
+
+    -  --statistics DAYS
+       Purge entries from the statistics tables that are more than DAYS days 
+       old.
+
+    -  --temp-uploads
+       Delete temporary uploads from the uploaded_files table older than the 
+       number of days specified in the :ref:`UploadPurgeTemporaryFilesDays` 
+       system preference.
+
+    -  --temp-uploads-days DAYS
+       Override the :ref:`UploadPurgeTemporaryFilesDays` system preference value.
+
+    -  --transfers DAYS
+       Purge transfers completed more than DAYS days ago from the 
+       branchtransfers table.
+
+    -  --unique-holidays DAYS
+       Delete all unique holidays from the special_holidays table older than DAYS
+
+    -  --uploads-missing FLAG 
+       Delete upload records for missing files when FLAG is true, count them otherwise
+
+    -  -v|--verbose
+       verbose mode
+
+    -  --zebraqueue DAYS
+       Purge completed zebraqueue entries older than DAYS days.
+       Defaults to 30 days if no days specified.
+
+    -  --z3950
+       Purge records from import tables that are the result of Z39.50 searches.
+       To purge all other import information, see the --import parameter above.
+
 .. _cron-share-usage-stats-label:
 
 Share usage stats
index 9b0c1c8..2f3f57d 100644 (file)
@@ -464,8 +464,7 @@ To add a new notice or slip
                 <item>"<<biblio.title>>" by <<biblio.author>>,
                 <<items.itemcallnumber>>, Barcode: <<items.barcode>> ,
                 Checkout date: <<issues.issuedate>>, Due date:
-                <<issues.date\_due>> Fine: <<items.fine>> Due date:
-                <<issues.date\_due>> </item>
+                <<issues.date\_due>> Fine: <<items.fine>> </item>
 
       -  **Important**