← Back to branch summary

~ubuntu-branches/debian/sid/calibre/sid

« back to all changes in this revision

Viewing changes to manual/edit.rst

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2014-02-27 07:48:06 UTC
  • mto: This revision was merged to the branch mainline in revision 74.
  • Revision ID: package-import@ubuntu.com-20140227074806-64wdebb3ptosxhhx
Tags: upstream-1.25.0+dfsg
Import upstream version 1.25.0+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
manual/edit.rst
17
17
.. image:: images/edit-book.png
18
18
    :alt: The Edit Book tool
19
19
    :align: center
 
20
    :class: fit-img
20
21
 
21
22
.. contents:: Contents
22
23
  :depth: 2
74
75
files inside ebooks are compressed, so the size of the final book is not the
75
76
sum of the individual file sizes.
76
77
 
77
 
Many files have special special meaning, in the book. These will typically have
 
78
Many files have special meaning, in the book. These will typically have
78
79
an icon next to their names, indicating the special meaning. For example, in
79
80
the picture to the left, you can see that the files :guilabel:`cover_image.jpg`
80
81
and :guilabel:`titlepage.xhtml` have the ocon of a cover next to them, this
235
236
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
236
237
 
237
238
There is a dedicated tool to ease editing of the Table of Contents. Launch it
238
 
with :guilabel:`Tools->Edit Table of Contents`. 
 
239
with :guilabel:`Tools->Table of Contents->Edit Table of Contents`. 
239
240
 
240
241
.. image:: images/tocedit.png
241
242
    :alt: The Edit Table of Contents tool
366
367
first use the Check Book tool to correct all problems and only then run
367
368
beautify.  Accessed via :guilabel:`Tools->Beautify all files`.
368
369
 
 
370
 
 
371
Insert inline Table of Contents
 
372
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
373
 
 
374
Normally in ebooks, the Table of Contents is separate from the main text and is
 
375
typically accessed via a special Table of Contents button/menu in the ebook
 
376
reading device. You can also have |app| automatically generate an *inline*
 
377
Table of Contents that becomes part of the text of the book. It is
 
378
generated based on the currently defined Table of Contents. 
 
379
 
 
380
If you use this tool multiple times, each invocation will cause the previously
 
381
created inline Table of Contents to be replaced. The tool can be accessed via
 
382
:guilabel:`Tools->Table of Contents->Insert inline Table of Contents`.
 
383
 
 
384
.. _checkpoints:
 
385
 
369
386
Checkpoints
370
387
------------------------
371
388
 
375
392
created every time you run any of the automated tools described in the
376
393
previous section.
377
394
 
378
 
You can create a checkpoint via:guilabel:`Edit->Create checkpoint`. And go back
379
 
to a previous checkpoint with :guilabel:`Edit->Revert to before`
 
395
You can create a checkpoint via :guilabel:`Edit->Create checkpoint`. And go back
 
396
to a previous checkpoint with :guilabel:`Edit->Revert to ...`
380
397
 
381
398
The checkpointing functionality is in addition to the normal Undo/redo
382
399
mechanism when editing individual files. Checkpoints are particularly useful
383
400
for when changes are spread over multiple files in the book or when you wish to
384
401
be able to revert a large group of related changes as a whole.
385
402
 
 
403
You can see a list of available checkpoints via :guilabel:`View->Checkpoints`.
 
404
You can compare the current state of the book to a specified checkpoint
 
405
using the :ref:`diff` tool -- by selecting the checkpoint of interest and clicking
 
406
the :guilabel:`Compare` button. The :guilabel:`Revert to` button restores the
 
407
book to the selected checkpoint, undoing all changes since that checkpoint was
 
408
created.
 
409
 
386
410
The Live Preview panel
387
411
------------------------
388
412
 
471
495
favorites by clicking the :guilabel:`Re-arrange favorties` button and then drag
472
496
and dropping the characters in favorites around.
473
497
 
 
498
You can also directly type in special characters using the keyboard. To do
 
499
this, you type the unicode code for the character (in hexadecimal) and then
 
500
press the :guilabel:`Alt+X` key which will convert the previously typed code
 
501
into the corresponding character. For example, to type ÿ you would type ff and
 
502
then Alt+X. To type a non-breaking space you would use a0 and then
 
503
:guilabel:`Alt+X`, to type the horizontal ellipsis you would use 2026 and
 
504
:guilabel:`Alt+X` and so on.
 
505
 
474
506
The code inspector view
475
507
^^^^^^^^^^^^^^^^^^^^^^^^^^
476
508