Cutlery/calibre
1
0
Fork 0
mirror of https://github.com/kovidgoyal/calibre.git synced 2025-07-09 03:04:10 -04:00
Code Issues Packages Projects Releases Wiki Activity

Conversion: Allow getting text for entries int he Table of Contents from tag attributes. Fixes #1267837 [[Enhancement] option to always use title attribute for chapter titles in TOC](https://bugs.launchpad.net/calibre/+bug/1267837)

Browse Source
This commit is contained in:
Kovid Goyal 2014-01-11 15:45:06 +05:30
parent 772ea98f77
commit 0a84e0c56f
1 changed files with 24 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
manual/conversion.rst
View File

@ -536,6 +536,30 @@ Use the following HTML markup to achieve this
Set the :guilabel:`Level 1 TOC` setting to ``//h:h2``. Then, for chapter two, |app| will take the title from the value of the ``title`` attribute on the ``<h2>`` tag, since the tag has no text.
Using tag attributes to supply the text for entries in the Table of Contents
-----------------------------------------------------------------------------
If you have particularly long chapter titles and want shortened versions in the
Table of Contents, you can use the title attribute to achieve this, for
example:
.. code-block:: html
<html>
<body>
<h2 title="Chapter 1">Chapter 1: Some very long title</h2>
<p>chapter 1 text...</p>
<h2 title="Chapter 2">Chapter 2: Some other very long title</h2>
<p>chapter 2 text...</p>
</body>
</html>
Set the :guilabel:`Level 1 TOC` setting to ``//h:h2/@title``. Then |app| will
take the title from the value of the ``title`` attribute on the ``<h2>`` tags,
instead of using the text inside the tag. Note the trailing ``/@title`` on the
XPath expression, you can use this form to tell |app| to get the text from any
attribute you like.
How options are set/saved for Conversion
-------------------------------------------