FAQ

  1. How fast is Sphinx from Word?

    It generates the .rst files at about 2 pages per second.

  2. Can you give me some example of using the options to tweak my website?

  1. To hide the Table of Contents on the pages (but keep it in the side bar):

CSS=div.toctree-wrapper { display:none }

  1. To change the color of the header bar:

themeOption=headbgcolor:#99ccff

  1. To set the width of the sidebar to 150 pixels:

SideBarWidth=150

  1. To reduce the size of the font in the page footer

CSS=.footnote{font-size:60%}

  1. Help! My internal hyperlinks are messed up.

  1. We’ve noticed on a few occasions that shortcuts get messed up. This appears to be because Word creates hidden bookmarks when you make an internal hyperlink. If you then edit the text around the link target (eg a Section Header), the bookmark can become displaced. When you then create a hyperlink to that bookmark, Word notices it is wrong and creates a new one with a _1 suffix, but any link that you previously set up, will still point to the displaced bookmark.

  2. To fix this, you need to delete the broken bookmarks and recreate them:

  1. Press Ctrl+Shift+F5 to bring up the bookmark list.

    Click ‘Hidden Bookmarks’ off, and then click ‘Hidden Bookmarks’ on again.
    The hidden bookmarks now appear in the list – they have an underscore prefix.

  2. Delete all the bookmarks with _1 (or _2 etc.) AND the bookmark with the same but not the _1 suffix.

  3. Then go through your document and make sure every link to the broken bookmarks is pointing to the correct place – the bookmark is (re)created as soon as it is needed.

  1. Tip: you can quickly see where a hyperlink points by putting the cursor over the link and pressing Shift+F9 (then Shift+F9 to bring back the visible text). We’ve included Ctrl+K (create link) and Alt+K (change link) to make this slightly quicker.

  1. How can I change the title of the table of contents?

    Use the TOCTitle option.