<commit_before>cmddocs
=======

``cmddocs`` is an interactive commandline wiki-like python script. It
lets you easily maintain your wiki/docs/cheetsheets using:

-  Python
-  ``cmd`` module (for CLI)
-  ``git`` for version control
-  ``markdown`` for writing and viewing
-  oldschool files and directories in your $HOME

Why ?
-----

I kind of started ``cmddocs`` because I couldn't find something like
this on the internet. Here's my usecase. Im working as a DevOps guy
being in touch with various types of software, languages, tools,
operating systems and databases. To remember all those things I need a
place to store commands, workflows and short howtos.

Most of the software I use (and love) runs on a OpenBSD Box on the
internet and are commandline-based. These are
`mutt <http://www.mutt.org>`__,
`taskwarrior <http://taskwarrior.org>`__,
`jrnl <http://maebert.github.io/jrnl/>`__,
`weechat <http://weechat.org>`__ and so on...But i was missing a tool
for documentation.

I was using `gitit <http://gitit.net>`__ also for a long time, but I
found that its way too bloated for my needs. Compiling ``ghc`` and
``gitit`` was awful, too. After switching to just plaintext files using
my ``vim`` and ``git`` it was also a bit annoying. So I wrote
``cmddocs`` to make it easier for me to handle my plaintext files.

Demo
----

To give you an idea what it looks/feels like I created a short terminal
recording.

`asciinema cmddocs demo <https://asciinema.org/a/15168>`__

Installation and usage
----------------------

Installation

::

    pip install cmddocs

Also make sure you have `tree` installed.

Create ``.cmddocsrc`` file in your $HOME with the following content
(adjust to your needs):

::

    [General]
    Datadir = /home/noqqe/Docs
    Default_Commit_Message = small changes
    Excludedir = .git/
    Editor = /usr/local/bin/vim
    Pager = /usr/bin/less
    Prompt = cmddocs>
    Promptcolor = 37
    Intro_Message = cmddocs - press ? for help
    Mail = <EMAIL>
    Default_Extension = md
<commit_msg>Documentation: updated Readme for Pagerflags<commit_after>cmddocs
=======

``cmddocs`` is an interactive commandline wiki-like python script. It
lets you easily maintain your wiki/docs/cheetsheets using:

-  Python
-  ``cmd`` module (for CLI)
-  ``git`` for version control
-  ``markdown`` for writing and viewing
-  oldschool files and directories in your $HOME

Why ?
-----

I kind of started ``cmddocs`` because I couldn't find something like
this on the internet. Here's my usecase. Im working as a DevOps guy
being in touch with various types of software, languages, tools,
operating systems and databases. To remember all those things I need a
place to store commands, workflows and short howtos.

Most of the software I use (and love) runs on a OpenBSD Box on the
internet and are commandline-based. These are
`mutt <http://www.mutt.org>`__,
`taskwarrior <http://taskwarrior.org>`__,
`jrnl <http://maebert.github.io/jrnl/>`__,
`weechat <http://weechat.org>`__ and so on...But i was missing a tool
for documentation.

I was using `gitit <http://gitit.net>`__ also for a long time, but I
found that its way too bloated for my needs. Compiling ``ghc`` and
``gitit`` was awful, too. After switching to just plaintext files using
my ``vim`` and ``git`` it was also a bit annoying. So I wrote
``cmddocs`` to make it easier for me to handle my plaintext files.

Demo
----

To give you an idea what it looks/feels like I created a short terminal
recording.

`asciinema cmddocs demo <https://asciinema.org/a/15168>`__

Installation and usage
----------------------

Installation

::

    pip install cmddocs

Also make sure you have `tree` installed.

Create ``.cmddocsrc`` file in your $HOME with the following content
(adjust to your needs):

::

    [General]
    Datadir = /home/noqqe/Docs
    Default_Commit_Message = small changes
    Excludedir = .git/
    Editor = /usr/local/bin/vim
    Pager = /usr/bin/less
    PagerFlags = -fr
    Prompt = cmddocs>
    Promptcolor = 37
    Intro_Message = cmddocs - press ? for help
    Mail = <EMAIL>
    Default_Extension = md

{'fraction_non_alphanumeric': 0.10967269174401563, 'fraction_numerical': 0.003419638495359062, 'mean_word_length': 3.446254071661238, 'pattern_counts': {'":': 0, '<': 17, '<?xml version=': 0, '>': 19, 'https://': 2, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '554266', 'n_tokens_mistral': 1324, 'n_tokens_neox': 1261, 'n_words': 536}