2nd Edition

.gitignore

@@ -103,4 +103,8 @@ Generated_Code #added for RIA/Silverlight projects
 _UpgradeReport_Files/
 Backup*/
 UpgradeLog*.XML
-UpgradeLog*.htm
+UpgradeLog*.htm
+
+
+# Containerized build volume
+build/output

BuildWithDocker.ps1

@@ -0,0 +1,6 @@
+$IMG=docker build . -q
+if (-not (Test-Path -Path build/output)) {
+    New-Item -Type Directory build/output
+}
+$Output=resolve-path ./build/output
+docker run --rm -v ${Output}:/output $IMG

Dockerfile

@@ -0,0 +1,57 @@
+# Original example (ContractOps) uses .NET base because it includes a .NET project
+FROM mcr.microsoft.com/dotnet/runtime:7.0 AS base
+# I don't think we need .NET. However, the base debian image doesn't have all the libraries
+# pandoc wants, so we're using that for now
+#FROM debian:12-slim
+
+# Or perhaps we should just use https://hub.docker.com/r/pandoc/latex
+
+# Install pandoc, MiKTeX, and rsvg-convert
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        dirmngr \
+        gpg \
+        gpg-agent \
+        librsvg2-bin \
+        wget \
+        xz-utils \
+    && apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D6BC243565B2087BC3F897C9277A7293F59E4889 \
+    && echo "deb http://miktex.org/download/debian bullseye universe" | tee /etc/apt/sources.list.d/miktex.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        miktex \
+    && miktexsetup finish \
+    && wget https://github.com/jgm/pandoc/releases/download/3.1.6.2/pandoc-3.1.6.2-1-amd64.deb \
+    && dpkg -i ./pandoc-3.1.6.2-1-amd64.deb \
+    && rm ./pandoc-3.1.6.2-1-amd64.deb \
+    && apt-get autoremove -y \
+    && apt-get clean -y \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /pandoc-lua-filters
+RUN wget https://raw.githubusercontent.com/pandoc-ext/pagebreak/main/pagebreak.lua \
+    && wget https://raw.githubusercontent.com/alpianon/pandoc-inline-headers/master/crossref-ordered-list \
+    && mv crossref-ordered-list crossref-ordered-list.lua \
+    && wget https://gitlab.com/howdyadoc/toolchain/-/raw/master/howdyadoc/lua-filters/inline-headers.lua
+
+WORKDIR /pandoc-filters
+RUN wget https://github.com/lierdakil/pandoc-crossref/releases/download/v0.3.16.0f/pandoc-crossref-Linux.tar.xz \
+    && tar -xJf pandoc-crossref-Linux.tar.xz \
+    && rm pandoc-crossref-Linux.tar.xz
+
+# Allow MikTeX to install things it needs
+RUN initexmf --set-config-value=[MPM]AutoInstall=yes
+
+WORKDIR /app
+
+RUN mkdir content
+COPY ["build/pandoc.sh","pandoc.sh"]
+COPY ["content","content"]
+COPY ["templates","templates"]
+COPY ["metadata.md","metadata.md"]
+COPY ["intro-rx-dotnet-book-cover.png","intro-rx-dotnet-book-cover.png"]
+
+VOLUME ["/output"]
+ENTRYPOINT ["/bin/sh", "/app/pandoc.sh"]

build/pandoc.sh

@@ -0,0 +1,81 @@
+#/bin/sh
+# To be run inside the container
+pandoc -o /output/intro-to-rx.epub metadata.md -s \
+    ./content/01_WhyRx.md \
+    ./content/02_KeyTypes.md \
+    ./content/03_CreatingObservableSequences.md \
+    ./content/04_Part2.md \
+    ./content/05_Filtering.md \
+    ./content/06_Transformation.md \
+    ./content/07_Aggregation.md \
+    ./content/08_Partitioning.md \
+    ./content/09_CombiningSequences.md \
+    ./content/10_Part3.md \
+    ./content/11_SchedulingAndThreading.md \
+    ./content/12_Timing.md \
+    ./content/13_LeavingIObservable.md \
+    ./content/14_ErrorHandlingOperators.md \
+    ./content/15_PublishingOperators.md \
+    ./content/16_TestingRx.md \
+    ./content/A_IoStreams.md \
+    ./content/B_Disposables.md \
+    ./content/C_UsageGuidelines.md \
+    ./content/D_AlgebraicUnderpinnings.md \
+    --epub-cover-image intro-rx-dotnet-book-cover.png \
+    --toc --toc-depth 4 \
+    --resource-path "./content/"
+
+pandoc -o /output/intro-to-rx.docx -s \
+    ./content/01_WhyRx.md \
+    ./content/02_KeyTypes.md \
+    ./content/03_CreatingObservableSequences.md \
+    ./content/04_Part2.md \
+    ./content/05_Filtering.md \
+    ./content/06_Transformation.md \
+    ./content/07_Aggregation.md \
+    ./content/08_Partitioning.md \
+    ./content/09_CombiningSequences.md \
+    ./content/10_Part3.md \
+    ./content/11_SchedulingAndThreading.md \
+    ./content/12_Timing.md \
+    ./content/13_LeavingIObservable.md \
+    ./content/14_ErrorHandlingOperators.md \
+    ./content/15_PublishingOperators.md \
+    ./content/16_TestingRx.md \
+    ./content/A_IoStreams.md \
+    ./content/B_Disposables.md \
+    ./content/C_UsageGuidelines.md \
+    ./content/D_AlgebraicUnderpinnings.md \
+    --resource-path "./content/" \
+    --metadata-file=metadata.md \
+    --metadata title="Introduction to Rx .NET" \
+    --toc --toc-depth 4
+
+pandoc -o /output/intro-to-rx.pdf metadata.md -s \
+    ./content/01_WhyRx.md \
+    ./content/02_KeyTypes.md \
+    ./content/03_CreatingObservableSequences.md \
+    ./content/04_Part2.md \
+    ./content/05_Filtering.md \
+    ./content/06_Transformation.md \
+    ./content/07_Aggregation.md \
+    ./content/08_Partitioning.md \
+    ./content/09_CombiningSequences.md \
+    ./content/10_Part3.md \
+    ./content/11_SchedulingAndThreading.md \
+    ./content/12_Timing.md \
+    ./content/13_LeavingIObservable.md \
+    ./content/14_ErrorHandlingOperators.md \
+    ./content/15_PublishingOperators.md \
+    ./content/16_TestingRx.md \
+    ./content/A_IoStreams.md \
+    ./content/B_Disposables.md \
+    ./content/C_UsageGuidelines.md \
+    ./content/D_AlgebraicUnderpinnings.md \
+    --resource-path "./content/" \
+    --template ./templates/eisvogel \
+    --toc --toc-depth 4
+
+if [ -f /root/.miktex/texmfs/data/miktex/log/pdflatex.log ]; then
+    cp /root/.miktex/texmfs/data/miktex/log/pdflatex.log /output
+fi