Sami's Site: CSB - Trellix Publish
previous    next

Subdirectory
Creating a subdirectory can be done in several ways.
This chart helps identify when it's best to let CSB make the subdirectory for you!

Automatically by CSB.
Manually.    Using one of these ways:
If you want to use CSB to publish web pages that include text, images, files, music, sound, container pages, etc to a subdirectory, let CSB make that subdirectory for you:
Check off that you want to publish to a subdirectory and name it
The very first time that you click to publish that tlx design file, CSB will connect to your website, check for your subdirectory and not find it.
CSB will make the folder then upload the web pages to your new subdirectory!   Your main site is not disturbed.

If you manually create the subdirectory, CSB may not be able to publish to it.  CSB4 doesn't seem to have a problem, but some have encountered problems with Trellix...
Make your subdirectory with one of these methods if you plan to upload your files manually to that folder.  

1) file manager, cPanel or other interface offered by a web host company for your website account.
2) with an FTP program  (read more on this page)

This kind of subdirectory would allow you to store:
downloadable files (pdf, sound, movies, etc) files in one folder
multiple pages that have been made by outside programs exactly as they are (like special photo gallery or  family tree files, etc) (, made by that other program)  

Have a large tlx design file?  And want to split it into more manageable pieces?
Publishing will be faster and site is easier to maintain with subdirectories!
KW has a great tutorial on his site that walks step by step through the process
to split a very large single tlx file into several smaller ones.  It can be seen here.


When you use subdirectories, your website will be built by having many CSB/Trellix .tlx files.
Each subdirectory will have it's own file!

For this website (samisite.com), I use several tlx files. One for each subdirectory.  
I set the same host settings, and the subdirectory name is different for each tlx file.
Each subdirectory was made by CSB when I published the tlx file the first time

MAIN.tlx - My home page, web building page, CSB websites, list of tutorials, etc.

PUBLISH.tlx - this file contains pages that pertain to publishing issues.   YOU ARE HERE.
You are on the page: http://www.samisite.com/publish/id80.htm

PHOTO.tlx - this file contains pages that pertain only to working with images, photos, animations, etc.

COLOR.tlx - this file contains pages that pertain only to the color charts for CSB.


ANY tlx file can be your MAIN website file, or published to a subdirectory.
You control by telling it the host setup and checking or not checking the subdirectory box and supplying a name!
For a main directory: Set up host, then do not check box for subdirectory.
For a subdirectory: Set up/choose the same host, then check the box  to publish to a subdirectory in the publishing options, then name the subdirectory.

All pages in a single tlx file get published to the same folder on your website.
You can not have some pages upload to the main area, and some pages into a subdirectory.
If you publish the file to two different subdirectories, or two different sites, ALL THE PAGES will publish to that folder!

Making a new subdirectory - "I want to start another group of pages in a new subdirectory."
You must have another CSB/Trellix tlx file. You can do it one of two ways. In either case, you still have the original file for your main site. And now you would have a second file that contains pages that only pertain to the subdirectory topic. (lets call it vacation2004)
Either:
1) create a brand new file from scratch, put the pages you want into it and publish to your new subdirectory vacation2004, or
2) take a file you have now and FILE SAVE AS and RENAME the file to your new subdirectory. Now you can modify existing pages, insert new pages, delete old pages, etc. But when you publish this file, it publishes to the subdirectory vacation2004 instead of the main area of the site.   
NOTE:  Using a new tlx file does not generate a warning.
But if you use a previously published tlx file (which is perfectly fine), the file will have a memory of being published to the previous location and produce a warning.  CSB is just letting you know that if you proceed, the file won't remember the previous location and wants to make sure you really want the file to go somewhere different.  As long as you have a new subdirectory name listed in the subdirectory box, click YES and your file will now publish to the subdirectory!   example here

Subdirectory NAMING RULES
Try to limit length of name. Short is better. Single word.  No spaces or symbols [exception: _ underscore and - dash]  
(Note: some servers are very finicky about caps!  photos, Photos, PHOTOS, PhoTos are all different!  Consider using all lowercase!)
movieposter is ok
movie poster is not
test_csb is ok
test csb is not
MarkandJohn is ok
Mark&John is not
Subdirectory Updating
Once you assign the subdirectory name in the publishing options, CSB holds it for you for future publishing.  You only have to assign that subdirectory name once.  Just open the tlx file, insert a new page (either using insert on menubar or right click on map > insert). When you publish the next time, the new page will be sent to the subdirectory on your website.
Let's say you already have a tlx file made for the subdirectory baseball with 3 pages in it and now you want to add a new page to that subdirectory.  Open the file, add a page and publish.  The file will not disturb your main site.  It will remember to go to the baseball subdirectory!

Subdirectory LINKING
You can use absolute or relative inking to go from main directory to sub, or sub to sub, or sub to main.

Absolute linking is a full URL address: http://www.samisite.com
This is necessary for any link coming in from offsite, or any link going out offsite.
You may also choose to use this as the standard way you input links. That's fine.
Link to a page in photos subdirectory: http://www.samisite.com/photo/id93.htm
Link from photo directory back to home page:   http://www.samisite.com
TIP:  the easy way to link to your new subdirectory:
publish it, open it in a browser window, capture the URL address, paste that address into a URL link!

Relative linking.... it's shorter, less typing.
NOTE: You will receive a warning notice from the program because you will not be putting a full address into the field. That's ok. Say YES you want to continue.
It is telling the server to stay in the same website, and then do the following:
/ goes back to your main (root) directory
../ goes up one directory

id93.htm = to another page in the same directory
/photo/id93.htm = to the root directory, then into subdirectory photo, to page 93.htm
../id93.htm = go up one level, to page 93.htm
/gallery/93.htm = go to root directory, to subdirectory gallery to page 93.htm (from one subdirectory to another)
../gallery/93.htm = go up one level into subdirectory gallery to page 93.htm  (from a subdirectory within another subdirectory  like gallery/vacation2004/id12.htm back to gallery)

Subdirectory Home Page
Something to keep in mind for your newly created subdirectories: (before you upload to your site): Each tlx file must have one page checked as a "home page" that CSB will rename index.htm. If you do not want to lose a page name to index, then create a page that will be the default for that file.

Example 1: Use a table of contents (gateway) for that subdirectory: If you type in http://www.samisite.com/photo/ it defaults to a page named index.htm (like every other tlx file), but I have made that page a table of contents for that particular subdirectory.

Example 2: Default to the main page in the subdirectory: If you type in http://www.samisite.com/color/ and http://www.samisite.com/color/index.htm are the same page. The first page in the file is the main CSB color chart. This subdirectory I wanted to default to a page rather than an index of pages.


Subdirectory Other Pages
Your home page in each subdirectory will be index.htm.  But what about the other pages in the subdirectory?

Page Names:   Consider leaving page names the same if you already have incoming links for the site.
Best way to avoid problems? Follow standard naming practices for page names, downloadable files, music, anchors, subdirectories, images, and ANYTHING YOU POINT TO that can become part of a webpage address.
Use lowercase, avoid caps if possible. Some servers will see mypage.htm and MyPage.htm as two different pages and others consider it to be the same page! If you are currently on a server that says they are the same and move your site to one that knows they are different, your links WILL NOT WORK.
DO NOT use SPACES in the names. Browsers do not allow spaces in URL addresses so don't do it. CSB tries to put in proper characters for you to patch your mistake, but do not rely on the program to do it for you.
DO NOT use SYMBOLS in the names. With the exception of (underline). Worst violation! Browsers do not allow symbols in URL addresses. CSB struggles with how to translate the bad input into HTML code that will work in browsers.
Keep them short as possible. Really long names can make linking difficult.
Examples:
BAD: vacation 2005
BAD: vacation w/family 2005
BAD: Photos & Music
GOOD: vacation2005
GOOD: vacation_with_family_2005
GOOD: photos_and_music

>> Web page name in CSB 3 and CSB 4:

CSB will use the default numbering system id1.htm, id2.htm, etc to name your web pages.

To change that name to a text name that makes sense:
- Right click the page
- Choose PROPERTIES, PAGE (or from the toolbar choose EDIT, PROPERTIES, PAGE)
- On the FIELDS tab, put a name into the SHORT TITLE field.
(Example: type in contact and it becomes contact.htm when you publish the page, CSB adds the extension .htm)
- Click APPLY, OK
DO NOT put your subdirectory name into the SHORT TITLE field.  Put in only the page name.

The content in Short Title field overrides the id number.
If the Short Title field had framesorno typed in it, you would be visiting this page:
http://www.samisite.com/publish/framesorno.htm
Short Title is EMPTY on this sample so CSB assigned the web page name: id80.htm
Since the page is in the publish directory, the full URL address of this page you are on now is:
http://www.samisite.com/publish/id80.htm

>> Web page name in CSB 5:

CSB will no longer default to the page ID like previous versions.  The new default: the page title will prefill the file NAME FIELD.

To change that name to a text name that makes sense:
- Right click the page
- Choose PROPERTIES, PAGE (or from the toolbar choose EDIT, PROPERTIES, PAGE)
- On the FIELDS tab:
- UNCHECK THE BOX  to set File Name from Title and type your own page name if you use characters in your page name!!!  (True especially if you use ' ! * " (<>) or other characters)   Set your OWN page name!!!
- put a name into the FILE NAME field.
(Example: type in framesorno and it becomes framesorno.htm when you publish the page, CSB adds the extension .htm)
- Click APPLY, OK
DO NOT put your subdirectory name into the FILE NAME field.  Put in only the page name.
File Name has text in it so the this becomes the web page name.
 CSB assigns the file extension so the page is: framesorno.htm

Since the page is in the publish directory, the full URL address of the page is: http://www.samisite.com/publish/framesorno.htm

(Note for people that upgraded from earlier CSB:
if you have old pages made before CSB5, the name you used will be retained.)

Subdirectory settings in CSB
Once you have your individual files, how do you get them onto your site?
The image below shows how the settings for a new subdirectory called test-csb would look for my site.
When you add a subdirectory, just check the box to publish to a subdirectory, and name the subdirectory and
the name of the subdirectory will appear in the URL.  Your FTP site information stays the same with no changes.
If you already have a folder on your site called posters, do not choose that as a subdirectory.
Choose an unused name so CSB (or Trellix) can create a new directory.  Now publish.
Each time you publish after that, the subdirectory name will remain so CSB will not overwrite a different directory UNLESS YOU change that subdirectory name!



Subdirectory Multi Levels
You can create a subdirectory inside another subdirectory.  Sorting information into practical sections makes sense.  But too much of a good thing is still a bad idea.  Limit your subdirectory levels to 2 or 3 at most!  Keep your names SHORT for best results.

The table below demonstrates that you can have a month folder inside a year folder inside your photo subdirectory.   If your folder does not exist, CSB will create it for you when you publish!
 Sample subdirectory addresses/links
(not active...some don't exist)
Publish to Subdirectory
(input this into the field)
How many sub levels used?
http://www.samisite.com/photo/
photo
1
http://www.samisite.com/photo/2004
photo/2004
2
http://www.samisite.com/photo/2004/april
photo/2004/april
3
http://www.samisite.com/photo/2004/august
photo/2004/august
3
Note: Trudy asked a great question on the forum about layering subdirectories. And Rick responded with YES and described how.  Thought I would add my take on the subject so it's all in one place.  Thanks for the idea folks!


Subdirectory Renaming Web Pages and Search Engines  VERY IMPORTANT.
If you split a large file into several smaller files to make subdirectories you will need to do more to retain your search engine rankings.  
The visitor will be used to visiting your web page at  http://yourwebspace.com/id12.htm
But you have moved that page, and renamed it to be http://yourwebspace.com/buttons/blue.htm
Search engines will be confused and links to the old page are broken.

You need to REDIRECT your visitors to your new pages.  There are a few ways to do it.

SERVER SIDE REDIRECT is your best option.
This is an instruction on the server that tells incoming visitors that the page http://yourwebspace.com/id12.htm has been renamed or moved to this place: http://yourwebspace.com/buttons/blue.htm   When put in place on the server level, your visitors do not see the rerouting of traffic.  They just arrive at the page you want them to see.  Neat and clean.  Setting a PERMANENT REDIRECT is your best option and accepted by the search engines.
Check your control panel at your host to see if REDIRECT is an option built in.  Some hosts offer cPANEL, which makes setting up a redirect a snap.
Even if that is not possible, if you are on LINUX server, you can do that easily with your .htaccess file which is relatively easy to do. You can read a good tutorial here:    
If you are on a WINDOWS server, check with your host for the best way to do it.

WEB PAGE REDIRECT USING SCRIPTS: If you can make the redirect on the server (noted above), don't do this!
This is a last resort option if you can not set a server-side redirect.
If you can not do server-side redirect:
Open your CSB MAIN FILE, the one with the main domain home page (mine would have the samisite.com home page).
If you have not already deleted the pages: clean out the contents of the pages (or at least limit content) that are moved to the subdirectories. Make the pages plain white with no borders.
If you have already deleted the pages:, insert a PLAIN WHITE PAGE (turn off borders) for each of the IMPORTANT pages, and name them exactly what the old page was.  For example, if you had http://yourwebspace.com/id12.htm then in short title field (CSB 3/4) or file name field (CSB 5) type in id12
Add a REDIRECT script to each of those pages and nothing else. Take a look at this page for 3 different examples: or you can put a message on the page (like please update your bookmark/favorites) then it will forward after a certain amount of time:


Subdirectory ORDER = VERY IMPORTANT.
You will be redesigning and rebuilding behind the scenes.  Build your subdirectories first.  
Get them linked back and forth from subdirectory to subdirectoy and from subdirectory to the pages you will keep in your main directory (like home page, contact page, etc).

As you split your subdirectories, you can begin to make changes to your main directory to start pointing to the new subdirectories.  But at this point, you keep the old pages (removing or limiting content) and pointing to the new pages. So even though you still have a page called id80.htm in your main directory, put a link or redirect over to the NEW subdirectory page: mysite.com/buttons/id80.htm  or mysite.com/buttons/blue.htm . This is slow process but helps the search engines to find the new pages naturally without doing much harm to the rankings.  

Finally, you tackle your last project, your main directory.  
If you have server-side redirects in place:  you can safely remove all the pages you put in other subdirectories, file save as and give a new name then publish your new main directory.  The server will send search engines to the new pages automatically and this will help to correct the search engine spider results.
If you have web page redirects:  make sure that each of the old pages has been cleaned out to just a blank white page, a redirect script has been put on the page.  Do a file save as and give a new name and publish your new main directory.
UPDATE your robots.txt file
UPDATE your site map  (If you don't have one, make one.  It helps the search engines...link from several pages, especially high up on your HOME PAGE.)


SUBDOMAIN VS SUBDIRECTORY!
A subdomain is also known as a "third-level" domain, and is a great way to create memorable web addresses for various areas of your site. Example:
http:// subdomain . domain . com
subdomain=3rd level, domain=2nd level, com=1st level

Say your web address is www.assortedstuff.com, and you created a subdomain for your catalog. After you set it up, the web address would be http://catalog.assortedstuff.com. This would go to a different area of your site than just http://assortedstuff.com

Technically, a subdomain is a subdirectory inside your main website- you would publish the same way!
The visitors could reach the area using either method:
Preferred: http://catalog.assortedstuff.com or
Like a sub: http://assortedstuff.com/catalog

But a subdirectory is not treated the same as a subdomain. It can only be reached by this method. http://assortedstuff.com/catalog.

If you want to use multiple DOMAIN names to point to different areas of your storage area with most hosts, including TCH, you have to use a reseller account. You can not have a DOMAIN name point to a subdomain or subdirectory. Example: If you build a site for bakery.com and you want to store it in your area, it must be a reseller account so you can point the domain name bakery.com to your storage area and still host your assorteddtuff.com, etc.