pymarkdownroh 0.0.1

A python package to create markdown text.

pymarkdownroh

The pymarkdownroh package contains pyhton modules to create markdown text from python scripts.

Table of Contents

1. Introduction
2. Getting started
   1. Prerequisites
   2. Installation
3. How to use
   1. How to import
   2. Using the module
4. Releasing
5. License

Introduction

This package contains different modules which enable users to write markdown text via python objects. It implements all aspects of the official Markdown Documentation.

The intention of this package is to automatically write markdown files using scripts with templates.

Currently it does not support extended functionality like tables which are often used in github flavored markdown.

Getting started

Prerequisites

• Python installed
• Operatingsystem: Linux or Windows, not tested on mac
• IDE like VS Code, if you want to contribute or change the code

Installation

There are two ways to install this module depending on the way you work and the preinstalled modules:

1. pip install pymarkdownroh
2. python -m pip install pymarkdownroh

How to use

How to import

You can import the module in two ways:

    import pymarkdownroh

This will import all functions. Even the ones that are not supposed to be used (helper functions).

    from pymarkdownroh import *

This will import only the significant functions, meant for using.

Using the module

Example 1:

# Import all modules from package.
from pymarkdownroh import *

print(create_headline(1, "Document Title"))

# Output:
# 
# "# Document Title"

# Import all modules from package.
from pymarkdownroh import *

l = ["Apples", "Bananas", "Cherries"]

print(create_list(l, True, True))

# Output:
#
# 1. [] Apples
# 2. [] Bananas
# 3. [] Cherries

Releasing

Releases are published automatically when a tag is pushed to GitHub.

# Create release variable.
$Release = "x.x.x"
# Create commit.
git commit --allow-empty -m "Release $Release"
# Create tag.
git tag -a $Release -m "Version $Release"
# Push from original.
git push origin --tags
# Push from fork.
git push upstream --tags

License

MIT