Sample pages
All pages Page 1.0.0 Page 2.0.0 Page 3.0.0

4.x branch

Note: Version 4.6 is a Ruby only version!

You can find the input files for the Html Assembler site on the bundled version 4.x zip file. Below you can find some basic information on how to create the given htmls. Try to modify the sample files and get used to the program logic. The sample htmls are actually the ones from this site.

Step 1: Generating the html sample files

Platform independent steps:
  • extract all zip contents with their subfolders in a folder, preferably in a folder path witch doesn't contains spaces (and non English characters if in Windows)
    (tip: use extract all command in your archive manager, if you don't have one download 7-zip)
  • in the html development folder (for the samples is "x_htmlassembler453") should be at the same time the code or the executable, the recipe (for the sample htmlassembler_site_recipe.txt) and the page content folders
  • drag the recipe text file on the htmlassembler.exe and if all set correct you should have some htmls created
  • in older versions of Windows Visual Basic 6 runtime may be required, or use one of the methods below

Note: VB6 does not support Unicode, if you need unicode support use one of the following versions.

Ruby source execution:
  • install Ruby either 1.8.x or 1.9.x if not already installed
  • open terminal or Command Prompt
  • create the folder where the site will be built
  • copy in the folder the htmlassembler.rb file
  • go in the folder where the site will be built
  • place all input files and recipe in the folder
  • type: ruby htmlassembler.rb htmlassembler_site_recipe.txt
  • replace recipe argument at will
  • check created html files

Note: for first time use you can skip steps 3-4 and 6 by using the unzipped folder with the sample files.

Step 2: Modifying the sample files

Next step is the editing of the input files (desc.txt and tech.txt files) and the sample recipe. Each column on the recipe file has a short description. As column separators TAB character is being used. One of the most important steps in the design process is the understanding of the hierarchy of each menu and page. Two columns are into this, the one is the parent of the page or menu (zero for top level items), the other is the hierarchical level from the top level (Top level is zero).

For the menu definition you have to set: The placing of the menu 1 for left side 2 for the right side. The type of the menu if it is a single item or a lister of the pages under the given. If page listing method is used a limit of items listed can be set by the limit column. And lastly the link address column in http or "PG:Page_number" format.

Pages defined info includes total picture number (name given: [pagefolder]/ph1.jpg, [pagefolder]/ph2.jpg and so on as well as text or monospace text block to be imported from [pagefolder]/desc.txt and [pagefolder]/tech.txt files. T for true, F for false.

It is highly recomended that you use an advanced text editor such as Notepad++ for windows or gedit for linux.

The input text of Html Assembler for this site (included in the zip bundle):

Actual 4.x recipe code:
Program Version:4.5

Menu Count:9
Hierarhical Menus:2
HTML Pages:13
Hierarhical Pages:3

Language codec:ISO-8859-1
Language name short:en

Site Title:Html Assembler
Browser Title:Html Assembler
Site Header:<h1 style='text-align: center; vertical-align: middle; font-size:180%; padding: 1% 0% 0% 0%;'>Html Assembler</h1>
Site Footer:Html Assembler, a GNU GPL v3 program


MENU: Hierarhical Parent Place NAME PageListing PreviewLim PageLink
1 0 0 1 Navigation 0 100 PG:0
2 1 1 1 Home 0 0 PG:1
3 1 1 1 News 0 0 PG:2
4 1 1 1 Documentation 0 0 PG:3
5 1 1 1 Download 0 0 PG:4
6 0 0 1 Sample pages 0 100 PG:0
7 1 6 1 Page 1.0.0 0 0 PG:5
8 1 6 1 Page 2.0.0 0 0 PG:9
9 1 6 1 Page 3.0.0 0 0 PG:13
PAGE Hierarhical Parent NAME PATH NAME P D T
1 0 0 Home index 0 T F
2 0 0 News news 0 T F
3 0 0 Documentation documentation 0 T T
4 0 0 Download download 0 T F
5 0 0 Page 1.0.0 p100 0 T F
6 1 5 Page 1.1.0 p110 0 F F
7 1 5 Page 1.2.0 p120 0 F F
8 2 7 Page 1.2.1 p121 0 F F
9 0 0 Page 2.0.0 p200 0 F T
10 1 9 Page 2.1.0 p210 0 F F
11 2 10 Page 2.1.1 p211 0 F F
12 2 10 Page 2.1.2 p212 0 F F
13 0 0 Page 3.0.0 p300 0 F F