# pukram2html

## Introduction

The `pukram2html` library is a Rust library that converts text written in the Pukram markup language to HTML. Pukram is a simple and intuitive markup language inspired by Markdown, designed for easy formatting of text content. The library is primarily targeted at developers building web servers who need to convert Pukram-formatted text into HTML for displaying on websites. Additionally, it can be used to convert Pukram text files to HTML, which can then be further converted to PDF using other tools.

## Pukram Markup Language

Pukram is a lightweight markup language that supports basic formatting and structural elements. Here are the key features of Pukram:

### Headers
Headers in Pukram are created by starting a line with one or more `#` characters. The number of `#` determines the header level (e.g., `#` for `<h1>`, `##` for `<h2>`, etc.).

### Lists
Lists in Pukram are created by starting a line with `-` for unordered lists or `+` for special list elements. Lists can be nested by increasing the indentation level.

### Special List Element Behavior
List elements starting with `+` can have special behavior defined for them, such as inserting links, images, or audio files.

### Formatting Markups
Pukram supports the following formatting markups:

- **Normal**: Plain text without any formatting.
- **Bold**: Text surrounded by `*` characters (e.g., `*bold*`).
- **Italic**: Text surrounded by `/` characters (e.g., `/italic/`).
- **Monospace**: Text surrounded by `` ` `` characters (e.g., `` `mono` ``).
- **Superscript**: Text surrounded by `^` characters (e.g., `^superscript^`).
- **Subscript**: Text surrounded by `|` characters (e.g., `|subscript|`).
- **Small**: Text surrounded by `^|` and `|^` delimiters (e.g., `^|small|^`).
- **Underscore**: Text surrounded by `_` characters (e.g., `_underscore_`).
- **Strikethrough**: Text surrounded by `~` characters (e.g., `~strikethrough~`).

Note that formatting is reset at the end of each line, so you can apply formatting to an entire line without needing closing delimiters.

## Library Structure

The `pukram2html` library consists of several components that work together to convert Pukram text to HTML:

- `TextInfo` struct: Holds information about the converted text, such as the number of lines, words, and characters.
- `convert` function: The main entry point for converting Pukram text to HTML.
- `convert_subheader` function: Converts Pukram text to HTML with subheaders.
- `convert_extended` function: Converts Pukram text to HTML with extended settings.
- `Settings` struct: Holds configuration settings for the conversion process.
- `FormattingExtensions` trait: Provides methods for handling formatting markups.

## API Reference

The API reference documentation provides detailed information about each module, struct, trait, and function in the `pukram2html` library, including their parameters, return values, and behavior. Consult the API reference for a comprehensive understanding of the library's components and how to use them effectively.

## Troubleshooting

If you encounter any issues while using the `pukram2html` library, refer to the troubleshooting section for common problems and their solutions. The FAQs section addresses frequently asked questions and provides additional guidance on using the library.

If you still have questions or need further assistance, don't hesitate to reach out to the library's maintainers or the Rust community for support.