Navigation Bar Home Download Store Support About Us Getting Started Faq Tips Advanced Issues
   
 

 


advanced issues

Now that you’ve created your site,
add a few finishing touches.


After you run Deep Navel, inside your site's root folder and in each of your tab folders you'll find a file called nav_properties.dnp.

This file gives you more control over how you build your site. Opening it and making a few simple text changes enables you to

The nav_properties.dnp file contains the following default values.


You can change the way Deep Navel creates your nav bar by changing the properties in this file. To do this, you open it in a text editor such as TextEdit. (When Deep Navel is running, double-clicking on the nav_properties.dnp file opens it automatically in TextEdit for you.)

 


preventing certain folders in your site structure from becoming tabs in your nav bar

By default, Deep Navel turns all first-level folders in a site into tabs, and all subfolders in those folders into sub-tabs. To overwrite these defaults, open the nav_properties.dnp file.

You'll be modifying the :SUBFOLDERS property.

Deep Navel's default is :SUBFOLDERS (:rest)
You can, however, exempt specified folders from becoming tabs by entering :rest-except (enter folder or sub-folder names here)

Example:
:SUBFOLDERS (:rest-except ("images" "hidden"))

Now when you re-run Deep Navel, the nav bars will include all folders except those mentioned in the list of folders. (Be sure to include the quotation marks, and all parenthesis.)

You can also specify that Deep Navel not include any subfolders as sub-tabs by entering the:none property:

Example:
:SUBFOLDERS (:none)


changing the order in which tabs appear

By default, Deep Navel lists tabs and sub-tabs left to right in alphabetical order.

To overwrite default alphabetical ordering, open the nav_properties.dnp file.

You will be modifying the :SUBFOLDERS property.

One option is to list all the folder names in the order you want the tabs to appear. For instance, if your site has folders “about us”, “home”, “images”, “news”, “products”, “services”, and “support”, and you want the “about us” folder to appear last, and the “products” and “services” folders should appear before “news”, you can order it as follows:

:SUBFOLDERS ("home" "products" "services" "news" "images" "about us")

If you've already read the section on preventing folders from becoming tabs, you may by now have realized you can modify your folder order and at the same time exclude certain folders. If in the above example you want to prevent the “images” folder from becoming a tab and keep the “about us” folder as the last tab, you specify it as follows:

:SUBFOLDERS ("home" :REST-EXCEPT ("images") "about us")

The complete nav_properties.dnp file would look like this:


tabs (and folders) using two or more words

Deep Navel converts folder names that are two or more words separated by dashes (-) or underscores (_) into strings with spaces in the tab name. For instance, a folder named “about_us” in the Finder will appear on the Deep Navel tab as “about us”.

As a design guideline, you should avoid using spaces in your folder names, as those names will result in URLs with space characters (%20), which can be messy.

You can use print names to have simple folder names appear as multiple words or a phrase in your tabs. To do that, specify the :PRINT-NAME property of the folder you wish in its nav_properties.dnp file. For instance, if you want to have a tab or sub-tab called “In The Press” that include your company’s press coverage, you can have a folder that is called “press” and define the print-name of that folder to be “In the press” in the nav_properties.dnp file (located in the “press” folder) as follows:
:PRINT-NAME "In The Press"


 


adding your logo to the navigation bar

To include an image, e.g. your company’s logo, in the tab, first place the logo image file in the folder where you want to have it appear. In our example below, we want to have our company’s logo, saved in a file called “nav_badge.png” to appear in our home tab.

Then edit the nav_properties.dnp file to include a line that defines the badge file name and position relative to the left top corner of the tab as shown below:
:BADGE (:FILE "nav_badge.png" :DX 20 :DY -10)
In this example, we wanted an image called “nav_badge.png” placed 20 pixels to the right of the left top corner of the tab (DX) and 10 pixels above the top left corner of the tab (DY) as shown in the figure below.

If you do not want to have both the text (name of the folder) and the image appear on the tab, please set the print name of that tab to the empty string in the nav_properties.dnp file as follows:
:PRINT-NAME ""

For this example, the complete nav_properties.dnp file in the folder where the logo image appears would look like this:



including the nav bar in all html files in a folder
(not just the index.html file)

In a folder or subfolder, Deep Navel by default only updates the index.html file with the navigation bar. However, if you want Deep Navel to include the navigation bar in all HTML files, you can use the :UPDATE-ALL-HTML-P property and set it to “true” in the nav_properties.dnp file, as follows:
:update-all-html-p t

The complete nav_properties.dnp file for this example, would look like this:

 

 

 

 

deeper nav

It's all here.

Want to prevent certain folders from turning into tabs?

Or rearrange your tab order?

Interested in creating multi-word tab titles?

Or inserting a logo in the nav bar?