Editing

There are many tools to operate on the coldoc; most have a command line and a web interface as well.

Command line tools have many options (not documented here), see respective --help.

One useful operation is to add new nodes to the tree of blobs. From command line,

python3 ${COLDOC_SRC_ROOT}/ColDocDjango/helper.py  add_blob

If you edit the blobs directly in the filesystem, and not using the web interface, then the django database will be desyncronized regarding metadata: run

python3 ${COLDOC_SRC_ROOT}/ColDocDjango/helper.py   --coldoc-nick NICK reparse_all

Moreover from time to time you will need to recreate the PDF and HTML representations.

Use

python3 ${COLDOC_SRC_ROOT}/ColDocDjango/latex.py   --coldoc-nick NICK main_private

to recreate the complete HTML PDF (visible only to editors); use

python3 ${COLDOC_SRC_ROOT}/ColDocDjango/latex.py   --coldoc-nick NICK main_public

to recreate the public HTML PDF (visible only to everybody); use

python3 ${COLDOC_SRC_ROOT}/ColDocDjango/latex.py   --coldoc-nick NICK tree

to recreate the HTML PDF for each blob (this is useful if you edited many blobs in the filesystem); use

python3 ${COLDOC_SRC_ROOT}/ColDocDjango/latex.py   --coldoc-nick NICK all

to run all of the above.

Note that when you edit a blob using the web interface, it is automatically reparsed and HTML and PDF are recomputed; but the private and public complete documents are not recompiled automatically, you have to either use the command above or the button in the web interface (visible only to editors).