<commit_before>Pandoc docker image (webuni/pandoc)
===================================

Pandoc is a document converter, widely used as a writing tool (especially by scholars) and as a basis for publishing
workflows.

Usage
-----

```bash
docker run --rm -v `pwd`:/app -w /app webuni/pandoc http://pandoc.org/MANUAL.html -t markdown
```

Tags
----

 Tag         | Size
 ----------- | ----
 latest, 2.5 | [![](https://images.microbadger.com/badges/image/webuni/pandoc.svg)](https://microbadger.com/images/webuni/pandoc)
 2.5         | [![](https://images.microbadger.com/badges/image/webuni/pandoc:2.5.svg)](https://microbadger.com/images/webuni/pandoc:2.5)
 2.4         | [![](https://images.microbadger.com/badges/image/webuni/pandoc:2.4.svg)](https://microbadger.com/images/webuni/pandoc:2.4)
 2.3         | [![](https://images.microbadger.com/badges/image/webuni/pandoc:2.3.svg)](https://microbadger.com/images/webuni/pandoc:2.3)<commit_msg>[pandoc] Add note about pdf creating<commit_after>Pandoc docker image (webuni/pandoc)
===================================

Pandoc is a document converter, widely used as a writing tool (especially by scholars) and as a basis for publishing
workflows.

Usage
-----

```bash
docker run --rm -v `pwd`:/app -w /app webuni/pandoc http://pandoc.org/MANUAL.html -t markdown
```

### Creating a PDF

To produce a pdf pandoc requires a pdf engine (LaTeX, ConTeXt, Weasyprint etc.). We must connect
two containers via the ssh protocol. The easiest solution is to use docker compose.

So create a file `docker-compose.yml` with content:
```yaml
version: '3.1'
services:
  context:
    image: webuni/context
    volumes:
    - .:/app
    working_dir: /app
    command: sshd

  pandoc:
    image: webuni/pandoc
    volumes:
    - .:/app
    working_dir: /app
    environment:
      ALIAS_CONTEXT: ssh context context
```

And in the same directory run command:
```bash
docker-compose run --rm pandoc https://raw.githubusercontent.com/jgm/pandoc/master/MANUAL.txt -t context -o manual.pdf
```

Tags
----

 Tag         | Size
 ----------- | ----
 latest, 2.5 | [![](https://images.microbadger.com/badges/image/webuni/pandoc.svg)](https://microbadger.com/images/webuni/pandoc)
 2.5         | [![](https://images.microbadger.com/badges/image/webuni/pandoc:2.5.svg)](https://microbadger.com/images/webuni/pandoc:2.5)
 2.4         | [![](https://images.microbadger.com/badges/image/webuni/pandoc:2.4.svg)](https://microbadger.com/images/webuni/pandoc:2.4)
 2.3         | [![](https://images.microbadger.com/badges/image/webuni/pandoc:2.3.svg)](https://microbadger.com/images/webuni/pandoc:2.3)
{'fraction_non_alphanumeric': 0.19602598395108903, 'fraction_numerical': 0.016048910966755828, 'mean_word_length': 3.32013201320132, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 17, 'lorem ipsum': 0, 'www.': 0, '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': '3899717', 'n_tokens_mistral': 1004, 'n_tokens_neox': 917, 'n_words': 186}