From 966724f20ec119720962e410c1a6162ddf6c78f3 Mon Sep 17 00:00:00 2001
From: Kelvin DeCosta <decostakelvin@gmail.com>
Date: Fri, 24 Jul 2020 02:19:38 +0300
Subject: [PATCH] [docs/formats] Add Formats documentation

---
 .../formats/overview/colorization.webp        | Bin 0 -> 9964 bytes
 docs/formats/ansi.md                          |  44 ++++++++++
 docs/formats/html.md                          |  43 ++++++++++
 docs/formats/index.md                         |  81 ++++++++++++++++++
 docs/snippets/references/formatting.md        |   3 +
 5 files changed, 171 insertions(+)
 create mode 100644 docs/assets/images/diagrams/formats/overview/colorization.webp
 create mode 100644 docs/formats/ansi.md
 create mode 100644 docs/formats/html.md
 create mode 100644 docs/formats/index.md
 create mode 100644 docs/snippets/references/formatting.md

diff --git a/docs/assets/images/diagrams/formats/overview/colorization.webp b/docs/assets/images/diagrams/formats/overview/colorization.webp
new file mode 100644
index 0000000000000000000000000000000000000000..d807a46bdc11ec60eab69a02b946ad3f1e19e703
GIT binary patch
literal 9964
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
a`WACtp6%Kb*M5E)ZQ1z$AAHU=EdK|c#mK?{

literal 0
HcmV?d00001

diff --git a/docs/formats/ansi.md b/docs/formats/ansi.md
new file mode 100644
index 0000000..96f8617
--- /dev/null
+++ b/docs/formats/ansi.md
@@ -0,0 +1,44 @@
+---
+title: "ANSI - Formats - Picharsso"
+description: "The ANSI format"
+---
+
+# ANSI
+
+This format supports [ANSI Escape Codes](https://en.wikipedia.org/wiki/ANSI_escape_code).
+
+!!! info "Default"
+    Since it can be used to create **plain text documents**,
+    this format is chosen as the **default**.
+
+## Procedure
+
+This format is implemented by the [`AnsiFormatter`][picharsso.format.ansi.AnsiFormatter].
+
+--8<-- "docs/snippets/references/formatting.md"
+
+### Translation
+
+This format doesn't require any translation.
+
+??? abstract "Source"
+    Refer to the [`translate` function][picharsso.format.ansi.AnsiFormatter.translate]
+    for more information.
+
+### Colorization
+
+Using the [`sty` Python library](https://sty.mewo.dev/),
+color is applied to the elements of the `text_matrix`.
+
+??? abstract "Source"
+    Refer to the [`color` function][picharsso.format.ansi.AnsiFormatter.color]
+    for more information.
+
+### Unification
+
+Elements of each row of the `text_matrix` are joined to form
+lines, which are further joined to form one huge string of text.
+
+??? abstract "Source"
+    Refer to the [`unify` function][picharsso.format.ansi.AnsiFormatter.unify]
+    for more information.
diff --git a/docs/formats/html.md b/docs/formats/html.md
new file mode 100644
index 0000000..e3baa32
--- /dev/null
+++ b/docs/formats/html.md
@@ -0,0 +1,43 @@
+---
+title: "HTML - Formats - Picharsso"
+description: "The HTML format"
+---
+
+# HTML
+
+This format supports [HTML](https://en.wikipedia.org/wiki/HTML).
+
+## Procedure
+
+This format is implemented by the [`HtmlFormatter`][picharsso.format.html.HtmlFormatter].
+
+--8<-- "docs/snippets/references/formatting.md"
+
+### Translation
+
+This format requires some characters to be translated
+to their equivalent [HTML character entities](https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references).
+
+??? abstract "Source"
+    Refer to the [`translate` function][picharsso.format.html.HtmlFormatter.translate]
+    for more information.
+
+### Colorization
+
+Color is applied to each element in the `text_matrix` by
+wrapping it in a styled `<span>` element.
+
+??? abstract "Source"
+    Refer to the [`color` function][picharsso.format.html.HtmlFormatter.color]
+    for more information.
+
+### Unification
+
+Elements of each row of the `text_matrix` are joined to form
+lines.
+All lines are wrapped in a `<div>` elemen each.
+The entire text output is wrapped in a `<div>` element.
+
+??? abstract "Source"
+    Refer to the [`unify` function][picharsso.format.html.HtmlFormatter.unify]
+    for more information.
diff --git a/docs/formats/index.md b/docs/formats/index.md
new file mode 100644
index 0000000..45cb816
--- /dev/null
+++ b/docs/formats/index.md
@@ -0,0 +1,81 @@
+---
+title: "Formats - Picharsso"
+description: "An overview of the output formats of Picharsso"
+---
+
+# Formats
+
+After an `image` is coverted to a `text_matrix`,
+it must be formatted before it can be output.
+
+## Procedure
+
+There are steps involved in this process that are common to
+all `formatters`.
+Picharsso defines a [`BaseFormatter`][picharsso.format.base.BaseFormatter]
+that abstracts this general procedure.
+
+### Initialization
+
+This step assigns values to the parameters for the algorithms.
+
+#### Color
+
+The `colorize` parameter controls whether the output text must include the colors from the image.
+
+Consider the following image:
+
+--8<-- "docs/snippets/embed/subjects/instagram.html"
+
+Here's what it should look like:
+
+--8<-- "docs/snippets/chunks/format/colorize.md"
+
+#### Vectorization
+
+The `vcolor` attribute is a vectorized version of the `color` method.
+
+### Translation
+
+The elements of the `text_matrix` are encoded in the Unicode standard.
+
+Depending on the output format, these characters must be translated accordingly.
+
+??? abstract "Source"
+    Refer to the [`translate` function][picharsso.format.base.BaseFormatter.translate] for more information.
+
+### Colorization
+
+Colors are pooled from the original `image` by resizing it to the dimensions of the output text.
+This ensures that each character has a unique pixel, and thus, a unique color.
+
+With the vectorized `color` method, `vcolor`, the elements of the `text_matrix`
+are transformed into strings of text that represent
+the original character as well as its color.
+
+<div align="center">
+    <img alt="Text matrix colorization" src="/assets/images/diagrams/formats/overview/colorization.webp">
+</div>
+
+??? abstract "Source"
+    Refer to the [`color` function][picharsso.format.base.BaseFormatter.color] for more information.
+
+### Unification
+
+Finally, the `text_matrix` is unified into a single string of text.
+This text, when viewed through a means supporting the particular format,
+should look like the original image.
+
+??? abstract "Source"
+    Refer to the [`unify` function][picharsso.format.base.BaseFormatter.unify] for more information.
+
+## Varities
+
+All the following formats are implemented by a `formatter` 
+which inherits from the [`BaseFormatter`][picharsso.format.base.BaseFormatter].
+
+### ANSI
+:   The [ANSI format](/formats/ansi/) is implemented by the [`AnsiFormater`][picharsso.format.ansi.AnsiFormatter].
+
+### HTML
+:   The [HTML format](/formats/html/) is implemented by the [`HtmlFormater`][picharsso.format.html.HtmlFormatter].
diff --git a/docs/snippets/references/formatting.md b/docs/snippets/references/formatting.md
new file mode 100644
index 0000000..75bdcd0
--- /dev/null
+++ b/docs/snippets/references/formatting.md
@@ -0,0 +1,3 @@
+!!! question "Formatting"
+    Refer to the [procedure](/formats/#procedure) outlined in the Formats documentation
+    for an overview of the **steps common to all formats**.