Add docker support

Author: mmicu

Dockerfile

@@ -0,0 +1,20 @@
+FROM ubuntu:22.10
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && \
+ # Set timezone
+ ln -fs /usr/share/zoneinfo/America/New_York /etc/localtime && \
+ apt-get install -y tzdata && \
+ dpkg-reconfigure --frontend noninteractive tzdata && \
+ # Install `pandoc` and `markdownlint`
+ apt-get install make pandoc ruby texlive-xetex --yes && \
+ gem install mdl
+
+COPY Makefile /repo/
+COPY USAGE.md /repo/
+COPY README.md /repo/
+
+RUN mkdir /repo/artifacts
+
+WORKDIR /repo

Makefile

@@ -1,18 +1,22 @@
 .DEFAULT_GOAL := all
 
 INPUT_FILE = README.md
-OUTPUT_FILE = artifacts/python-for-coding-interview.pdf
+USAGE_FILE = USAGE.md
+OUTPUT_DIR = artifacts
+OUTPUT_FILE = $(OUTPUT_DIR)/python-for-coding-interview.pdf
 
 .PHONY: linter
 linter:
-markdownlint $(INPUT_FILE) --disable MD013 MD025
+mdl -r ~MD013 "$(INPUT_FILE)"
+mdl -r ~MD013 "$(USAGE_FILE)"
 
 .PHONY: pdf
 pdf:
-pandoc $(INPUT_FILE) \
+mkdir -p "$(OUTPUT_DIR)"
+pandoc "$(INPUT_FILE)" \
 --pdf-engine=xelatex \
 -M date="`date "+%B%e, %Y"`" \
--o $(OUTPUT_FILE)
+-o "$(OUTPUT_FILE)"
 
 .PHONY: all
 all: linter pdf

README.md

@@ -20,20 +20,20 @@ Additional material:
 
 ## Topics
 
-1. [Primitive Types](#primitive-types).
-1. [Tuples](#tuples).
-1. [Lists](#lists).
-1. [Strings](#strings).
-1. [Stacks](#stacks).
-1. [Queues](#queues).
-1. [Sets](#sets).
-1. [Hash Tables](#hash-tables).
-1. [Heaps](#heaps).
-1. [Collections](#collections):
- 1. [namedtuple](#collectionsnamedtuple).
- 1. [defaultdict](#collectionsdefaultdict).
- 1. [Counter](#collectionscounter).
- 1. [OrderedDict](#collectionsordereddict).
+1. [Primitive Types](#primitive-types)
+1. [Tuples](#tuples)
+1. [Lists](#lists)
+1. [Strings](#strings)
+1. [Stacks](#stacks)
+1. [Queues](#queues)
+1. [Sets](#sets)
+1. [Hash Tables](#hash-tables)
+1. [Heaps](#heaps)
+1. [Collections](#collections)
+ 1. [namedtuple](#collectionsnamedtuple)
+ 1. [defaultdict](#collectionsdefaultdict)
+ 1. [Counter](#collectionscounter)
+ 1. [OrderedDict](#collectionsordereddict)
 
 ## Primitive Types
 

USAGE.md

@@ -0,0 +1,20 @@
+# Usage
+
+## With docker
+
+```text
+docker build -t pfci:latest .
+# Linter
+docker run --rm pfci:latest make linter
+# Generate PDF
+docker run --rm -v %cd%\artifacts:/repo/artifacts pfci:latest make pdf
+```
+
+docker run --rm pfci:latest "make pdf &> /dev/null && ls /repos/" > ./artifacts/python-for-coding-interview.pdf
+
+## Without docker
+
+```text
+make linter
+make pdf
+```