Add the 'latex_engine' option

Bug #1712726 reported by Chason Chan on 2017-08-24
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Chason Chan

Bug Description

We need to change our typesetting engine to, e.g., "xelatex" or "lualatex"instead of plain "latex" or "pdflatex".

But the default typesetting engine of building LaTeX sources is "pdflatex". This will cause an error when generating the PDF as the following:

! Fatal fontspec error: "cannot-use-pdftex"
! The fontspec package requires either XeTeX or LuaTeX.
! You must change your typesetting engine to, e.g., "xelatex" or
! "lualatex"instead of plain "latex" or "pdflatex".
! See the fontspec documentation for further information.
! For immediate help type H <return>.

To fix it, configure the latex engine:

latex_engine = 'xelatex'

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [ ] This doc is inaccurate in this way: ______
- [ ] This is a doc addition request.
- [x] I have a fix to the document that I can paste below including example: input and output.

If you have a troubleshooting or support issue, use the following resources:

 - Ask OpenStack:
 - The mailing list:
 - IRC: 'openstack' channel on Freenode

Release: 1.16.2.dev17 on 2017-08-18 21:38
SHA: dddd24cc88859e90e72f16baf1e1e50184976e2d

Chason Chan (chen-xing) on 2017-08-24
Changed in openstack-doc-tools:
assignee: nobody → Chason (chen-xing)
importance: Undecided → Medium

Fix proposed to branch: master

Changed in openstack-doc-tools:
status: New → In Progress
Chason Chan (chen-xing) on 2017-08-24
summary: - The configuration lack the 'latex_engine' option
+ Add the 'latex_engine' option

Submitter: Jenkins
Branch: master

commit af471ca94062a646eab56b70010c28f8d6ae9d50
Author: chenxing <>
Date: Thu Aug 24 12:21:57 2017 +0800

    Update the configuration of generating a PDF document

    Change-Id: Ib02619173fb60ae834562ef54df6118f8390fc4a
    Closes-Bug: #1712726

Changed in openstack-doc-tools:
status: In Progress → Fix Released

This issue was fixed in the openstack/openstackdocstheme 1.17.0 release.

To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers