Sample pages
All pages Page 1.0.0 Page 2.0.0 Page 3.0.0

5.x branch

You can find the input files for the Html Assembler site on the bundled version 5 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 htms are actually the ones from this site.


Step 1: Generating the html sample files

Preparing everything:
  • 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 use windows download 7-zip)
  • in the html development folder (for the samples is "rb_htmlassembler5") 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
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.

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

Detailed manual for version 5 is included in the zip file.

The input text of Html Assembler for this site (included in the zip bundle): Actual 5.x recipe code:
HTML ASSEMBLER INPUT FORMAT
Program Version:5

Menu Sets:1
Menu Headers:3
Menus:4
Page Groups:7
Page Groups Hierarhical Levels:3
Pages:17

Language codec:utf-8
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

LabelPrev:Prev
LabelNext:Next
LabelUp:Up

MENU SETS:
id NAME
1 Default

MENU HEADERS:
id InSet Place NAME PageGroupList ListingType PreviewLim OverLimitPageLink
1 1 1 Navigation 0 N 0 0
2 1 1 Documentation 2 T 0 5
3 1 2 Sample pages 3 T 0 8

MENUS:
id InHeader NAME PageLink
1 1 Home PG:1
2 1 News PG:2
3 1 History PG:3
4 1 Download PG:4

PAGE GROUPS:
id Hierarhical Parent NAME DefaultPage CssStyle UsesMenuSet
1 0 0 General 1 T1Style1.css 1
2 0 0 Documentation 5 T1Style1.css 1
3 0 0 Sample pages 8 T1Style1.css 1
4 1 3 Pages 1.x 9 T1Style1.css 1
5 2 4 Pages 1.2.x 11 T1Style1.css 1
6 1 3 Pages 2.x 13 T1Style1.css 1
7 2 6 Pages 2.1.x 14 T1Style1.css 1

PAGES:
id InGroup NAME PATH NAME Photos Description(T/F) Technical(T/F) GroupListing ListingType(T=top-level, A=all-levels, N=none) Limit ListingBoxTitles
1 1 Home index 0 T F 0 N 0 -
2 1 News news 0 T F 0 N 0 -
3 1 History history 0 T F 0 N 0 -
4 1 Download download 0 T F 0 N 0 -
5 2 Summary docsum 0 T F 2 AR 0 Documentation articles:
6 2 4.5.x branch v4docs 0 T Actual 4.5.x recipe code: 0 N 0 -
7 2 5.x branch v5docs 0 T Actual 5.x recipe code: 0 N 0 -
8 3 All pages smpls 0 F F 3 A 0 Flat list of all sample pages:
9 3 Page 1.0.0 p100 0 T F 4 T 0 Page 1.x list:
10 4 Page 1.1.0 p110 0 F F 0 N 0 -
11 4 Page 1.2.0 p120 0 F F 5 T 0 Page 1.2.x list:
12 5 Page 1.2.1 p121 0 F F 0 N 0 -
13 3 Page 2.0.0 p200 0 F Code box 6 T 0 Page 2.x list:
14 6 Page 2.1.0 p210 0 F F 7 T 0 Page 2.1.x list:
15 7 Page 2.1.1 p211 0 F F 0 N 0 -
16 7 Page 2.1.2 p212 0 F F 0 N 0 -
17 3 Page 3.0.0 p300 0 F F 0 N 0 -