(BLOCK (HEADING 1 () "zettelstore-run" "zettelstore-run" (LITERAL-CODE () "zettelstore run")) (PARA (TEXT "This starts the web service.")) (VERBATIM-CODE () "zettelstore run [-a PORT] [-c CONFIGFILE] [-d DIR] [-debug] [-p PORT] [-r] [-v]") (DESCRIPTION () ((MARK "a" "a" "a" (LITERAL-INPUT () "-a PORT"))) (BLOCK (BLOCK (PARA (TEXT "Specifies the TCP port through which you can reach the ") (LINK () (ZETTEL "00001004100000") (TEXT "administrator console")) (TEXT ".") (SOFT) (TEXT "See the explanation of ") (LINK () (ZETTEL "00001004010000#admin-port") (LITERAL-INPUT () "admin-port")) (TEXT " for more details.")))) ((MARK "c" "c" "c" (LITERAL-INPUT () "-c CONFIGFILE"))) (BLOCK (BLOCK (PARA (TEXT "Specifies ") (LITERAL-INPUT () "CONFIGFILE") (TEXT " as a file, where ") (LINK () (ZETTEL "00001004010000") (TEXT "startup configuration data")) (TEXT " is read.") (SOFT) (TEXT "It is ignored if the given file is not available or not readable.")) (PARA (TEXT "Default: tries to read the following files in the ") (FORMAT-QUOTE () (TEXT "current directory")) (TEXT ": ") (LITERAL-INPUT () "zettelstore.cfg") (TEXT ", ") (LITERAL-INPUT () "zsconfig.txt") (TEXT ", ") (LITERAL-INPUT () "zscfg.txt") (TEXT ", ") (LITERAL-INPUT () "_zscfg") (TEXT ", and ") (LITERAL-INPUT () ".zscfg") (TEXT ".")))) ((MARK "d" "d" "d" (LITERAL-INPUT () "-d DIR"))) (BLOCK (BLOCK (PARA (TEXT "Specifies ") (LITERAL-INPUT () "DIR") (TEXT " as the directory that contains all zettel.")) (PARA (TEXT "Default is ") (LITERAL-INPUT () "./zettel") (TEXT " (") (LITERAL-INPUT () ".\\zettel") (TEXT " on Windows), where ") (LITERAL-INPUT () ".") (TEXT " denotes the ") (FORMAT-QUOTE () (TEXT "current directory")) (TEXT ".")))) ((MARK "debug" "debug" "debug" (LITERAL-INPUT () "-debug"))) (BLOCK (BLOCK (PARA (TEXT "Allows debugging of the internal web server.") (SOFT) (TEXT "Same as setting ") (LINK () (ZETTEL "00001004010000#debug-mode") (LITERAL-INPUT () "debug-mode")) (TEXT " to ") (FORMAT-QUOTE () (TEXT "true")) (TEXT ".")))) ((MARK "p" "p" "p" (LITERAL-INPUT () "-p PORT"))) (BLOCK (BLOCK (PARA (TEXT "Specifies the integer value ") (LITERAL-INPUT () "PORT") (TEXT " as the TCP port, where the Zettelstore web server listens for requests.")) (PARA (TEXT "Default: 23123.")) (PARA (TEXT "Zettelstore listens only on ") (LITERAL-INPUT () "127.0.0.1") (TEXT ", e.g. only requests from the current computer will be processed.")) (PARA (TEXT "If you want to listen on a specific network interface to process requests from other computers, please use ") (LINK () (ZETTEL "00001004010000#listen-addr") (LITERAL-INPUT () "listen-addr")) (TEXT " of the configuration file.")))) ((MARK "r" "r" "r" (LITERAL-INPUT () "-r"))) (BLOCK (BLOCK (PARA (TEXT "Puts the Zettelstore in read-only mode.") (SOFT) (TEXT "No changes are possible via the ") (LINK () (ZETTEL "00001014000000") (TEXT "web user interface")) (TEXT " / via the ") (LINK () (ZETTEL "00001012000000") (TEXT "API")) (TEXT ".")) (PARA (TEXT "This allows to publish your content without any risks of unauthorized changes.")))) ((MARK "v" "v" "v" (LITERAL-INPUT () "-v"))) (BLOCK (BLOCK (PARA (TEXT "Be more verbose when writing logs."))))) (PARA (TEXT "Command line options take precedence over ") (LINK () (ZETTEL "00001004010000") (TEXT "configuration file")) (TEXT " options.")))