diff --git a/Makefile b/Makefile index f8ed148..ca44d66 100644 --- a/Makefile +++ b/Makefile @@ -138,6 +138,13 @@ latexpdf: $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." +.PHONY: xelatexpdf +xelatexpdf: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through xelatex..." + $(MAKE) PDFLATEX=xelatex -C $(BUILDDIR)/latex all-pdf + @echo "xelatex finished; the PDF files are in $(BUILDDIR)/latex." + .PHONY: latexpdfja latexpdfja: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex diff --git a/conf.py b/conf.py index 3ded294..d21c1e0 100644 --- a/conf.py +++ b/conf.py @@ -54,7 +54,7 @@ master_doc = 'index' # General information about the project. project = 'ReadTheFreakingDocs' -copyright = '2017, Marc Beninca' +copyright = '' author = 'Marc Beninca' # The version info for the project you're documenting, acts as replacement for @@ -62,9 +62,9 @@ author = 'Marc Beninca' # built documents. # # The short X.Y version. -version = '0' +version = '' # The full version, including alpha/beta/rc tags. -release = '0' +release = '' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. @@ -124,7 +124,7 @@ todo_include_todos = True # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # -html_theme = 'alabaster' +html_theme = 'sphinx_rtd_theme' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the @@ -138,11 +138,11 @@ html_theme = 'alabaster' # The name for this set of Sphinx documents. # " v documentation" by default. # -# html_title = 'ReadTheFreakingDocs v0' +html_title = 'ReadTheFreakingDocs' # A shorter title for the navigation bar. Default is the same as html_title. # -# html_short_title = None +html_short_title = 'RTFD' # The name of an image file (relative to this directory) to place at the top # of the sidebar. @@ -200,15 +200,15 @@ html_static_path = ['_static'] # If true, links to the reST sources are added to the pages. # -# html_show_sourcelink = True +html_show_sourcelink = True # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. # -# html_show_sphinx = True +html_show_sphinx = False # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. # -# html_show_copyright = True +html_show_copyright = False # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the @@ -238,18 +238,27 @@ html_static_path = ['_static'] # html_search_scorer = 'scorer.js' # Output file base name for HTML help builder. -htmlhelp_basename = 'ReadTheFreakingDocsdoc' +htmlhelp_basename = 'ReadTheFreakingDocs' # -- Options for LaTeX output --------------------------------------------- latex_elements = { + + 'fontenc': r'\usepackage{fontspec}', + + 'fontpkg': r''' +\setmainfont{DejaVu Serif} +\setsansfont{DejaVu Sans} +\setmonofont{DejaVu Sans Mono} +''', + # The paper size ('letterpaper' or 'a4paper'). # - # 'papersize': 'letterpaper', + 'papersize': 'a4paper', # The font size ('10pt', '11pt' or '12pt'). # - # 'pointsize': '10pt', + 'pointsize': '12pt', # Additional stuff for the LaTeX preamble. # @@ -264,7 +273,7 @@ latex_elements = { # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ - (master_doc, 'ReadTheFreakingDocs.tex', 'ReadTheFreakingDocs Documentation', + (master_doc, 'ReadTheFreakingDocs.tex', 'ReadTheFreakingDocs', 'Marc Beninca', 'manual'), ] @@ -276,7 +285,7 @@ latex_documents = [ # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. # -# latex_use_parts = False +latex_use_parts = False # If true, show page references after internal links. # @@ -294,7 +303,7 @@ latex_documents = [ # \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added # packages. # -# latex_keep_old_macro_names = True +latex_keep_old_macro_names = False # If false, no module index is generated. # @@ -306,7 +315,7 @@ latex_documents = [ # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ - (master_doc, 'readthefreakingdocs', 'ReadTheFreakingDocs Documentation', + (master_doc, 'readthefreakingdocs', 'ReadTheFreakingDocs', [author], 1) ] @@ -321,7 +330,7 @@ man_pages = [ # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ - (master_doc, 'ReadTheFreakingDocs', 'ReadTheFreakingDocs Documentation', + (master_doc, 'ReadTheFreakingDocs', 'ReadTheFreakingDocs', author, 'ReadTheFreakingDocs', 'One line description of project.', 'Miscellaneous'), ]