DOCS-169 build support for a PDF of Use Cases

Author: Sam Kleinman

conf.py

@@ -168,6 +168,7 @@
 latex_documents = [
   # (source start file, target name, title, author, documentclass [howto/manual]).
     ('contents', 'MongoDB.tex', u'MongoDB Documentation', u'MongoDB Documentation Project', 'manual'),
+    ('applications/use-cases/index', 'MongoDB-use-case-studies.tex', u'MongoDB Use Case Studies ', u'MongoDB Documentation Project', 'manual'),
 ]
 
 latex_elements = { 'preamble': '\DeclareUnicodeCharacter{FF04}{\$} \DeclareUnicodeCharacter{FF0E}{.}',
@@ -190,7 +191,6 @@
 
 man_pages = [
   # (source start file, name, description, authors, manual section).
-    ('contents', 'mongodb', u'MongoDB Manual', [u'MongoDB Documentation Project'], 1),
     ('reference/bsondump', 'bsondump', u'MongoDB BSON utility', [u'MongoDB Documentation Project'], 1),
     ('reference/mongo', 'mongo', u'MongoDB Shell', [u'MongoDB Documentation Project'], 1),
     ('reference/mongod', 'mongod', u'MongoDB Server', [u'MongoDB Documentation Project'], 1),
@@ -204,6 +204,7 @@
     ('reference/mongostat', 'mongostat', u'MongoDB', [u'MongoDB Documentation Project'], 1),
     ('reference/mongosniff', 'mongosniff', u'MongoDB', [u'MongoDB Documentation Project'], 1),
     ('reference/mongotop', 'mongotop', u'MongoDB', [u'MongoDB Documentation Project'], 1),
+    ('contents', 'mongodb', u'MongoDB Manual', [u'MongoDB Documentation Project'], 1),
 ]
 
 

makefile

@@ -75,7 +75,7 @@ ifeq ($(MODE),publish)
 deploy: $(CURRENTBUILD)/release.txt $(CURRENTBUILD) $(publication-output)/index.html
 
 # Establish dependencies for building the manual.
-$(CURRENTBUILD):$(CURRENTBUILD)/MongoDB-Manual.pdf $(CURRENTBUILD)/MongoDB-Manual.epub $(CURRENTBUILD)/single/ $(CURRENTBUILD)/ 
+$(CURRENTBUILD):$(CURRENTBUILD)/MongoDB-Manual.pdf $(CURRENTBUILD)/MongoDB-Manual.epub $(CURRENTBUILD)/single/ $(CURRENTBUILD)/
 
 # Build and Migrate all required Manual Content
 $(CURRENTBUILD)/MongoDB-Manual-$(current-branch).pdf:$(BUILDDIR)/latex/MongoDB.pdf
@@ -218,7 +218,7 @@ aspirational-latex:
 	@echo "Run \`make' in that directory to run these through (pdf)latex" \
 	      "(use \`make latexpdf' here to do that automatically)."
 
-aspirational-latexpdf: aspirational-latex 
+aspirational-latexpdf: aspirational-latex
 	$(SPHINXBUILD) -b latex $(ASPIRATIONALOPTS) $(BUILDDIR)/aspiration-latex
 	@echo "Running LaTeX files through pdflatex..."
 	$(MAKE) -C $(BUILDDIR)/latex all-pdf
@@ -273,4 +273,9 @@ pdfs:latex
 	$(PDFLATEXCOMMAND) $(LATEXOPTS) '$<'
 	$(PDFLATEXCOMMAND) $(LATEXOPTS) '$<'
 
-
+case-studies:$(BUILDDIR)/latex/MongoDB-use-case-studies.pdf
+$(BUILDDIR)/latex/MongoDB-use-case-studies.tex:latex
+	sed -i -r -e '/^\\release.*$$/d' $@
+$(BUILDDIR)/latex/MongoDB-use-case-studies.pdf:$(BUILDDIR)/latex/MongoDB-use-case-studies.tex
+	$(PDFLATEXCOMMAND) $(LATEXOPTS) '$<'
+	$(PDFLATEXCOMMAND) $(LATEXOPTS) '$<'

source/applications/use-cases/index.txt

@@ -4,14 +4,32 @@
 Use Cases
 =========
 
+
+Real time Analytics
+-------------------
+
 .. toctree::
    :maxdepth: 2
 
    real-time-analytics-storing-log-data
    real-time-analytics-preaggregated-reports
    real-time-analytics-hierarchical-aggregation
+
+E-Commerce
+----------
+
+.. toctree::
+   :maxdepth: 2
+
    ecommerce-product-catalog
    ecommerce-inventory-management
    ecommerce-category-hierarchy
+
+Content Management Systems
+--------------------------
+
+.. toctree::
+   :maxdepth: 2
+
    cms-metadata-and-asset-management
    cms-storing-comments