Add the 'latex_engine' option

Bug #1712726 reported by Chason Chan
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstackdocstheme
Fix Released
Medium
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: http://ask.openstack.org
 - The mailing list: http://lists.openstack.org
 - IRC: 'openstack' channel on Freenode

-----------------------------------
Release: 1.16.2.dev17 on 2017-08-18 21:38
SHA: dddd24cc88859e90e72f16baf1e1e50184976e2d
Source: https://git.openstack.org/cgit/openstack/openstackdocstheme/tree/doc/source/index.rst
URL: https://docs.openstack.org/openstackdocstheme/latest/

Chason Chan (chen-xing)
Changed in openstack-doc-tools:
assignee: nobody → Chason (chen-xing)
importance: Undecided → Medium
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstackdocstheme (master)

Fix proposed to branch: master
Review: https://review.openstack.org/497006

Changed in openstack-doc-tools:
status: New → In Progress
Chason Chan (chen-xing)
summary: - The configuration lack the 'latex_engine' option
+ Add the 'latex_engine' option
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstackdocstheme (master)

Reviewed: https://review.openstack.org/497006
Committed: https://git.openstack.org/cgit/openstack/openstackdocstheme/commit/?id=af471ca94062a646eab56b70010c28f8d6ae9d50
Submitter: Jenkins
Branch: master

commit af471ca94062a646eab56b70010c28f8d6ae9d50
Author: chenxing <chen.xing@99cloud.net>
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
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/openstackdocstheme 1.17.0

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  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.