You need to customize the URL generator with your project's name. This generator helps you make quick links within your content.
Edit me
  1. 1. Build the default project
  2. 2. Add a new project
  3. 3. Decide on your project's attributes
  4. 4. Set the configuration options
  5. 6. Configure the sidebar
  6. 5. Customize the conditions file
  7. 7. Configure the top navigation
  8. → 8. Customize the URL generator
  9. 9. Set up Prince XML
  10. 10. Configure the build scripts

About the URL generator

The URL generator is a special file that helps you generate the code you need for links. This generator helps you avoid broken links, and ensures more consistency.

To learn more about the linking strategy used with this theme, see Links. The step here simply explains how to customize the URL generator for a new project.

Customize the URL generator

  1. In the project root directory, open urls_acme.txt (a file you should have already duplicated from urls_mydoc.txt) in an earlier step.
  2. Do a find a replace for “mydoc” with “acme”.

  3. Change the project conditions at the top:

     {% if site.project == "mydoc_writers" or site.project == "mydoc_designers" %}

    Add all the projects here that will use this URL generator. For example, if you have 3 different projects, list them here. Otherwise the file’s contents will be replaced with the values from the latest project that you run.

Notice that this URL generator iterates through the sidebar file only, and it doesn’t apply the attribute qualifiers as with the sidebar.html file. As such, this URL generator will work with the output from any of the project files.

Tags: navigation