Browse Source

docs: fix way too small figures in pdf

Marian Beermann 8 years ago
parent
commit
e80c0f7c5e
3 changed files with 10 additions and 2 deletions
  1. 1 0
      docs/conf.py
  2. 2 0
      docs/internals.rst
  3. 7 2
      docs/internals/data-structures.rst

+ 1 - 0
docs/conf.py

@@ -207,6 +207,7 @@ latex_logo = '_static/logo.pdf'
 latex_elements = {
 latex_elements = {
     'papersize': 'a4paper',
     'papersize': 'a4paper',
     'pointsize': '10pt',
     'pointsize': '10pt',
+    'figure_align': 'H',
 }
 }
 
 
 # For "manual" documents, if this is true, then toplevel headings are parts,
 # For "manual" documents, if this is true, then toplevel headings are parts,

+ 2 - 0
docs/internals.rst

@@ -27,6 +27,8 @@ chunk is checked against the :ref:`chunks cache <cache>`, which is a
 hash-table of all chunks that already exist.
 hash-table of all chunks that already exist.
 
 
 .. figure:: internals/structure.png
 .. figure:: internals/structure.png
+    :figwidth: 100%
+    :width: 100%
 
 
     Layers in Borg. On the very top commands are implemented, using
     Layers in Borg. On the very top commands are implemented, using
     a data access layer provided by the Archive and Item classes.
     a data access layer provided by the Archive and Item classes.

+ 7 - 2
docs/internals/data-structures.rst

@@ -204,8 +204,9 @@ commit is written to the new segment. Then, the old segment is deleted
 A simplified example (excluding conditional compaction and with simpler
 A simplified example (excluding conditional compaction and with simpler
 commit logic) showing the principal operation of compaction:
 commit logic) showing the principal operation of compaction:
 
 
-.. figure::
-    compaction.png
+.. figure:: compaction.png
+    :figwidth: 100%
+    :width: 100%
 
 
 (The actual algorithm is more complex to avoid various consistency issues, refer to
 (The actual algorithm is more complex to avoid various consistency issues, refer to
 the ``borg.repository`` module for more comments and documentation on these issues.)
 the ``borg.repository`` module for more comments and documentation on these issues.)
@@ -288,6 +289,8 @@ by their chunk ID, which is cryptographically derived from their contents.
 More on how this helps security in :ref:`security_structural_auth`.
 More on how this helps security in :ref:`security_structural_auth`.
 
 
 .. figure:: object-graph.png
 .. figure:: object-graph.png
+    :figwidth: 100%
+    :width: 100%
 
 
 .. _manifest:
 .. _manifest:
 
 
@@ -640,6 +643,8 @@ and both are stored in the chunk. Encryption and MAC use two different keys.
 Each chunk consists of ``TYPE(1)`` + ``MAC(32)`` + ``NONCE(8)`` + ``CIPHERTEXT``:
 Each chunk consists of ``TYPE(1)`` + ``MAC(32)`` + ``NONCE(8)`` + ``CIPHERTEXT``:
 
 
 .. figure:: encryption.png
 .. figure:: encryption.png
+    :figwidth: 100%
+    :width: 100%
 
 
 In AES-CTR mode you can think of the IV as the start value for the counter.
 In AES-CTR mode you can think of the IV as the start value for the counter.
 The counter itself is incremented by one after each 16 byte block.
 The counter itself is incremented by one after each 16 byte block.