N+ builder

N+ faq

N newsletter

download

rakit site

documentation v1.2 release date: 2001.03.19  
N+ Builder manual

Main Menu
GUI
Error Message dialogues
a sample site building procedure

N+ guide

Introduction
Setting up an N+ site
N+ system architecture
Markup Language syntax
Coding conventions and object methods

N Technology terms

Site
Page
Page parameters
Visitor
User
Neuron Client
Document
Document Class
Document Section
Document set
N+ markup language
N+ Builder
Project
Master HTML
Jewelmine HTML
Engine PHP script
Data provider function
Module
Variable
Box
Item
Condition




N+ guide

N Technology terms

N+ Builder manual

what is N?

N+ Builder Manual

Main Menu:

File menu:

  • File - New.
    Creates New Site to develop.
    Site: The site contains pages.
    Pages are fundamental building blocks of a site.
  • File - Open Site...
    Opens an existing site.
    When opening the site the application tries to open all contained pages automatically. In case of missing files the missing pages are marked red.
    Missing pages are not available for compilation.

  • File - Save Site.
    Stores currently edited site to disk (*.site) along with contained pages (*.page).
  • File - Import Page.
    Imports pre-configured page so, that it is not necessary to create it again manually.
    IMPORTANT! Can't import page if there is a page with the same name.
  • File -Export Page.
    Exports page to disk for later independent use. Insert exported pages to other sites with the "File - Import Page" function.
  • File - Exit.
    Exit from the N+ Builder application. Offers possibility to save site currently under development.

Actions menu:

  • Actions - Add New Page.
    Creates new page.
    Pages are fundamental building blocks of a site to be developped with N+ Builder.
    It will have an automatically generated name (i.e.: "untitled235") .

  • Actions - Remove Page.
    Removes unnecessary pages from the site.
  • Actions - Import HTML.
    Adds HTML files. To compile a page it must contain marked HTML files (N+ Markup Language).
    The firstly added HTML file is refered to as Master HTML. The Master HTML contains the page itself.
    The Master HTML's filename is the page name. This name will be used in URLs on other pages.
    You can also add Jewelmine HTML files to the page. This Jewelmine page contains page elements (i.e.: box, item) that appear in the Master HTML.
    IMPORTANT! HTML filenames must be named uniquely in the page. You can't add two HTML files with the same name, even if they are on a different path.
  • Actions - Remove HTML.
    Removes unnecessary HTML files from page.
    IMPORTANT! There's only one Master HTML in the page. The Master HTML file can't be removed from the page.
    In order to remove a Master HTML file the Jewelmine HTML must be changed to Master HTML.
  • Actions - Mark HTML as Master.
    Changes the Jewelmine HTML file to Master HTML file.
    IMPORTANT! The page name must be unique in a site. The same HTML file can't be added to two different sites.
  • Actions - Add Parameter.
    Adds Page Parameter to a page.
  • Actions - Remove Parameter.
    Removes parameter form page.
  • Actions - Add Include.
    Adds Page Include to a page.
  • Actions - Remove Include.
    Removes include from page.

Tools menu:

  • Tools - Compile.
    Compiles site. Only selected pages will be compiled. The compilation is a remote process. One must have access to the http://rakit.hu server. The communication is over HTTP so proxy and firewall can be used.)
    IMPORTANT! You must enter your registration key to use this function. For more on registration key see Help - Registration

Help menu:

  • Help - Registration.
    The registration key is needed for the N+ Builder compilation process. Get your own registration key from Rakit IT Development Ltd (http://rakit.hu).

GUI:

Icon descriptions:

Page - There is nothing in the page.

Page - Something already added (parameter, include, HTML).

Page after compilation - An error occured during the compillation process. Double-click on the icon to see results.

Page after compilation - Compilation successful. Double-click on the icon to see results.

Include - The engine's PHP file name with server side path.

Parameter - Page Parameter.

Master HTML.

Slave HTML (Jewel mine HTML).



Error Message dialogues:

  • Operation aborted. You already have a page named: "PAGE". Cannot import Page.
    There is a page already existing on the same name as the page about to be imported.
  • Operation aborted. You can associate a file with a page only once.
    Can't add an already added "FILE" to "PAGE".
  • File "FILE" is associated with an other page: "PAGE". Cannot import file.
    Can't add an already added "FILE" to "PAGE".
  • Operation aborted. Filename "FILE" already exists on the page: "PAGE".
    Can't add an already added "FILE" to "PAGE". Files path might be different.
  • Operation aborted. File: "FILE" already imported as Master HTML to page: "PAGE".
    Can't add an already added "FILE" to "PAGE". Master HTML gives the name of the page.
  • Operation aborted. File: "FILE" is already marked as a Master HTML on page: "PAGE".
    Can't add Jewelmine HTML as Master HTML if there is a "PAGE" in the site with the same name. Master HTML gives the name of the page.
  • Operation aborted. Master HTML files can't be removed.
    The page must contain a Master HTML.
  • Unable to open site file!
    File can't be opened due to error during opening a *.site file. Possible file system error.
  • Unable to import HTML file!
    File can't be opened due to error during opening a *.html file. Possible file system error.
  • Unable to import page file!
    File can't be opened due to error during opening a *.page file. Possible file system error.

Let's see a sample site building procedure.

The necessary files for this sample can be found in the sample sub-directory of the application base-directory.

Step 1.

Start N+ Builder application. The N+ Builder automatically starts with a new and empty site.
Note: If you start the application for the first time you have to register it in the Help - Registration. menu.

Step 2.

Add a New Page to the site with the Actions - Add New Page.

Step 3.

Add a Master HTML to the page with the Actions - Import HTML.
You can find the sample pre-commented HTML file in the sample directory

Step 4.

Add a parameter named "count" to the page with the Actions - Add Parameter menu.

Step 5.

Add an engine include named "sample.php" to the page with the Actions - Add Include menu.

Step 6.

Save this project to your disk for later use.
IMPORTANT! There is a pre-configured sample.site and sample.page file In the sample directory to be used for this sample. Do not overwrite it.

Step 7.

Start the compilation.
IMPORTANT! You have to be connected to the internet to do so.

Step 8.

If all goes well, you get a "Compilation successful" message in the message box and this icon: appears on the page.
Double click the icon to see the compilation results.
Check results at this URL: http://rakit.hu/n/sample/sample.php






© 2000-2001 rakit development ltd. all rights reserved.