.. -*- coding: utf-8 -*-
.. Copyright (C) 2019, Wolfgang Scherer, <Wolfgang.Scherer at gmx.de>
..
.. This file is part of Kallithea Deployment.
..
.. Permission is granted to copy, distribute and/or modify this document
.. under the terms of the GNU Free Documentation License, Version 1.3
.. or any later version published by the Free Software Foundation;
.. with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
.. A copy of the license is included in the section entitled "GNU
.. Free Documentation License".

.. inline comments (with du_comment_role)
.. role:: rem(comment)
.. role:: html(raw)
   :format: html
.. role:: shx(code)
   :language: sh

.. \||<-snip->|| start

.. =====================================================
.. :rem:`|||:sec:|||`\ GLOBAL DEFINITIONS (ALL VERSIONS)
.. =====================================================

.. (progn (forward-line 1) (snip-insert "rst_sphinx.doc_defs_snip_snap" t t "rst") (insert "\n"))
.. |<-snip->| replace:: \ :rem:`x`
.. |<-snap->| replace:: \ :rem:`x`
.. |<-sn0p->| replace:: \ :rem:`x`
.. |<-sn1p->| replace:: \ :rem:`x`
.. |<-sn2p->| replace:: \ :rem:`x`
.. |<-sn3p->| replace:: \ :rem:`x`
.. |<-sn4p->| replace:: \ :rem:`x`
.. |<-sn5p->| replace:: \ :rem:`x`
.. |<-sn6p->| replace:: \ :rem:`x`
.. |<-sn7p->| replace:: \ :rem:`x`
.. |<-sn8p->| replace:: \ :rem:`x`
.. |<-sn9p->| replace:: \ :rem:`x`
.. |<-sn#p->| replace:: \ :rem:`x`
.. |<-sn=p->| replace:: \ :rem:`x`
.. |<-sn-p->| replace:: \ :rem:`x`
.. |<-sn~p->| replace:: \ :rem:`x`
.. |<-sn.p->| replace:: \ :rem:`x`
.. |<-sn+p->| replace:: \ :rem:`x`

.. \|:here:|

.. |:todo:| replace:: **|:todo:|**

.. \|:here:|

.. _`Kallithea deployment documentation`: /kallithea/_mnt/kallithea-deploy/html/index.html
.. _`Kallithea deployment repository`: /kallithea/public/kallithea-deploy
.. _`Kallithea installed instance`: /kallithea/public/kallithea

.. _`Kallithea`: https://kallithea-scm.org/
.. _`Kallithea Documentation`: https://kallithea.readthedocs.io/en/stable/
.. _`conservancy / kallithea - Bitbucket`: https://bitbucket.org/conservancy/kallithea

.. _`Pylons`: https://github.com/Pylons/pylons
.. _`Pyramid`: https://github.com/Pylons/pyramid
.. _`TurboGears 2`: https://github.com/TurboGears/tg2
.. _`Paste Script`: https://github.com/cdent/pastescript/
.. _`Paste Deploy`: https://github.com/Pylons/pastedeploy/
.. _`Paste`: https://github.com/cdent/paste

.. _`GitHub - Pylons/pylons: Pylons Framework, community maintained with guidance/assistance from the Pylons Project. Merged with repoze.bfg for Pyramid framework.`: https://github.com/Pylons/pylons
.. _`GitHub - Pylons/pyramid: Pyramid - A Python web framework`: https://github.com/Pylons/pyramid
.. _`GitHub - TurboGears/tg2: Python web framework with full-stack layer implemented on top of a microframework core with support for MongoDB, Pluggable Applications and autogenerated Admin`: https://github.com/TurboGears/tg2
.. _`GitHub - cdent/pastescript: a pluggable command-line tool for paste`: https://github.com/cdent/pastescript/
.. _`GitHub - Pylons/pastedeploy: provides code to load WSGI applications and servers from URIs`: https://github.com/Pylons/pastedeploy/
.. _`GitHub - cdent/paste: Python Paste (core) repository`: https://github.com/cdent/paste

.. \|:here:|

.. ==================================================
.. :rem:`|||:sec:|||`\ END
.. ==================================================

.. \||<-snip->|| stop

.. (progn (forward-line 1) (snip-insert "rst_t.ide-update" t t "rst") (insert "\n"))
.. 
.. :ide-menu: Emacs IDE Main Menu - Buffer @BUFFER@
.. . M-x `eIDE-menu' ()(eIDE-menu "z")

.. :ide: CMD: align replace :: substitutions
.. . (progn (and (buffer-file-name) (save-buffer)) (shell-command (concat "sed 's,\",\"\",;s,^,\",;s,$,\",;s/ *replace" "::/\",\"replace" "::/p;d' " (buffer-file-name) " | xlsx-dump.sh --width 0 --header 0 --mode 'text,dense' ")))

.. :ide: +#-
.. . Tools ()

.. :ide: COMPILE: latexpdf
.. . (progn (and (buffer-file-name) (save-buffer)) (compile (concat "make -k latexpdf")))

.. :ide: COMPILE: html
.. . (progn (and (buffer-file-name) (save-buffer)) (compile (concat "make -k html")))

.. :ide: COMPILE: render reST as pseudoXML
.. . (let* ((fp (or (buffer-file-name) (concat default-directory (and (boundp 'sphinx-doc-master) sphinx-doc-master) "README.txt"))) (fn (file-name-nondirectory fp))) (save-match-data (if (string-match-t "[.][^.]*$" fn) (setq fn (replace-match "" nil t fn)))) (let ((args (concat " --traceback " (shell-quote-argument fp) " 2>&1 #| tee " (shell-quote-argument fn) ".pxml"))) (and (buffer-file-name) (save-buffer)) (compile (concat "PATH=\".:$PATH\"; ws_rst2pseudoxml.py " args))))

.. :ide: +#-
.. . Process ()

.. :ide: QUO: ~~ Subsubsection ~~
.. . (insert "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\:rem\:`|\:sec\:|`\\ ::fillme\::\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n" )

.. :ide: QUO: -- Subsection --
.. . (insert "--------------------------------------------------\n\:rem\:`||\:sec\:||`\\ ::fillme\::\n--------------------------------------------------\n" )

.. :ide: QUO: == Section ==
.. . (insert "==================================================\n\:rem\:`|||\:sec\:|||`\\ ::fillme\::\n==================================================\n" )

.. :ide: +#-
.. . Sections ()

.. :ide: OCCUR-OUTLINE:  `|||: sec :|||' + ^.. + command comments
.. . (x-symbol-tag-occur-outline "sec" '("|:" ":|") (cons (cons "^" ".. ") (cons nil nil)) "\\(_`[^`\n]+`\\|\\[[^]\n]+\\]\\|[|][^|\n]+[|]\\|[^:\n]+::\\)")

.. :ide: MENU-OUTLINE:  `|||: sec :|||' + ^.. + command comments
.. . (x-eIDE-menu-outline "sec" '("|:" ":|") (cons (cons "^" ".. ") (cons nil nil)) "\\(_`[^`\n]+`\\|\\[[^]\n]+\\]\\|[|][^|\n]+[|]\\|[^:\n]+::\\)")

.. 
.. Local Variables:
.. mode: rst
.. snip-mode: rst
.. truncate-lines: t
.. symbol-tag-symbol-regexp: "[-0-9A-Za-z_#]\\([-0-9A-Za-z_. ]*[-0-9A-Za-z_]\\|\\)"
.. symbol-tag-auto-comment-mode: nil
.. symbol-tag-srx-is-safe-with-nil-delimiters: nil
.. End: