Skip to main content

mynotes builds indexes and converts to HTML a tree of notes written in Markdown.

The index building phase creates new index files (still in Markdown) that contains links to files and subfolders of the local folder.

As example, index files for the tree

  • A/
    • a1.md

    • a2.md

  • B/
    • BB/
      • bb1.md

    • b1.md

  • c.md

are generated as following

  • A/
    • index.md (with links to a1.md and a2.md)

    • a1.md

    • a2.md

  • B/
    • index.md (with links to BB/index.md and b1.md)

    • BB/
      • index.md (with link to bb1.md)

      • bb1.md

    • b1.md

  • c.md

  • index.md (with links to A/index.md, B/index.md and c.md)

The html generation phase creates HTML files from Markdown files (including ToC and links to upper/top index).

Additional files that are not strictly part of the notes (thus files not with Markdown format) can be placed in folders _files. These folders are by default ignored when building the indexes and generating HTML files.

Installation

Python 3.6+ is required to run mynotes.

The package can be installed directly from PyPi using pip:

pip install mynotes

or downloaded from the release/tags page and then installed using pip:

pip install mynotes-xxx.tar.gz

Excecution

mynotes package contains two scripts for command line interaction.

  • mynotes-build builds the index files.

usage: mynotes-build [-h] [--verbose] [--config CONFIG]

Build index files for notes tree.

optional arguments:
-h, --help            show this help message and exit
--verbose, -v         Increase verbosity
--config CONFIG, -c CONFIG
                        Configuration file
  • mynotes-genhtml generates HTML files into a dedicated folder.

usage: mynotes-genhtml [-h] [--verbose] [--config CONFIG]

Generate HTML files for markdown files.

optional arguments:
-h, --help            show this help message and exit
--verbose, -v         Increase verbosity
--config CONFIG, -c CONFIG
                        Configuration file

Configuration

mynotes writes the its configuration in a configuration file (.mynotes.ini). This file is created automatically if it does not exist and default configuration values are used.

mynotes takes only into account section [mynotes] thus the configuration could be written in common file, e.g. setup.cfg.

The configuration keys are:

Key

Purpose

index

Name of index files (with markdown extension)

home

Main file of a directory (comes on top of the index list and is included in index HTML files.

excl_dirs

Directories to exclude, independent from path.

excl_files

Files to exclude, independent from path. The index file is not ignore when generating HTML files.

md_ext

Extension for Markdown files, must be used for index and home keys.

plugins_html

Activated plugins for HTML generation:

  • links-index: Generate links to upper/top index

  • toc: Generate toc

Example of configuration file:

[mynotes]
index = index.md
home = home.md
excl_dirs = .git _files _html
excl_files = .gitignore .python-version index.md Makefile .mynotes.ini
md_ext = .md
plugins_html = links-index toc

License

mynotes is licensed under the GNU General Public License version 3.

See LICENSE.

Metadata

Release files for mynotes 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mynotes 1.0.1
File Size Uploaded
mynotes-1.0.1.tar.gz 27.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mynotes 1.0.1
File Interpreter ABI Platform
mynotes-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 59.3 kB

Release files / mynotes-1.0.1.tar.gz

Download URL mynotes-1.0.1.tar.gz
Size 27.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1cb9b3ee0fe7d87694ff704cf30db71db3b0af861bb26a3c49bde8ee97664900
BLAKE2b-256 checksum
How to use checksums
091b10487bd016ff8e08e612e754523d2b7e9b646534d6e80d23c71c50ffd7e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release files / mynotes-1.0.1-py3-none-any.whl

Download URL mynotes-1.0.1-py3-none-any.whl
Size 32.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
63ba2ec8130be43fecf5f618d2a94162b09122fc93e2f37e7a4ecfbda8838122
BLAKE2b-256 checksum
How to use checksums
f64da9a976bdc5e0e2af3d1111d74ee23f920220d6d3ee5a05ca499f41bf29ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page