la.plume micro CMS

la.plume CMS Help

Installation note

To create a new page

(1) Open the password-protected admin page.

(2) In the "Page filename" box, enter a filename. Don't enter spaces or a file suffix (eg: .html or .php). The filename will be placed into the page's web address, eg: www.mysite.com/my-file. It will also be added to the navigation menu (Capitalized and with any hyphens converted to spaces) as My File linking to the page.

(3) In the "Content" box, the first line entered will become the small text banner right at the top of the page. This can be useful to "label" or categorise the page. The second line entered will become the large heading, eg: "la.plume CMS Help" on this page. This text will also become the page title tag in the head of the page, displayed only in the top bar of the browser. Make the third line into a blank line. Anything entered from the fourth line onwards will be the page content.

(4) Click the "Create page" button to create the page. Done!

Formatting text in the "Content" box

When a blank line is entered between sections of text, the correct paragraph tags are auto-inserted into the page's HTML, spacing out the content nicely into visual paragraphs. A single carriage return will insert a line break within a paragraph. You can also enter your own HTML markup. If for example, you create an HTML list, the paragraph tags will not be auto-inserted.

The example below is for a page like this one, showing the "Page filename" box and the "Content" box with the filename and content entered in.

To edit an existing page

(1) In the "Page filename" box, enter the filename of the page to be edited. The filenames of all existing pages are listed below the buttons.

(2) Click the "Get page content" button to get the content into the content box.

(3) Edit the content, taking care to preserve the text banner on the first line and the page heading on the second line, then leaving the third line empty.

(4) Click the "Overwrite existing" button to edit the page.

To delete an existing page

(1) In the "Page filename" box, enter the filename of the page to be deleted. The filenames of all existing pages are listed below the buttons.

(2) Click the "Delete page" button to delete the page.

If you deleted a page by accident, immediately after you did so, the page's filename and content should still be in their respective boxes. To recreate the page, click the "Create page" button before doing anything else.

The navigation menu

When a page is created, its filename will, by default, appear in the navigation menu. To prevent a new page appearing in the navigation menu, enter a hyphen at the beginning of the filename, eg: -mypage. The page will exist, and can be linked-to from the content of any other page. Otherwise it will remain private, for testing until you're happy enough with it to add it to the navigation menu (by creating it again without the leading hyphen) or adding links to it from other pages.

Except for 'home' and 'contact', the navigation menu is listed alphabetically.

Adding HTML markup

To add an image

Assuming the image was uploaded to the default image folder (see [ Upload or delete an image ] at the top of the admin page), the following HTML code can be used to add it to the page, substituting the real image filename:

<img src="/img/imagename.jpg" alt="My image" />

Note that the maximum width of an image is 540 pixels. A wider image will not fit. Also, by default, images are "floated" to the left of text in the same paragraph, therefore an image smaller than the full 540 pixel width should preferably be small enough in width to allow space for text to its right.

To add an image by itself, rather than within a paragraph of text, leave an empty line above and below the image HTML code.

To add a logo where the feather is on this website, upload a logo image with the filename logo.jpg (maximum width 184 pixels). Its precise position can be controlled by editing background-position in the stylesheet:

#menu {
position: absolute;
padding-bottom: 10px;
left: 15px;
top: 0px;
background: #fff url("img/logo.jpg") no-repeat;
background-position: 8px 6px;
}

To lower the navigation menu to make space for a deeper logo, edit the top margin in the following section of the stylesheet (currently set at 78px):

#menu ul {
margin: 78px 0 0 0;
padding: 0;
list-style-type: none;
font-size: 1.2em;
border-top: 1px solid #ccc;
}

To add a horizontal rule (line)

<div class="hr"><hr /></div>

Just add the above HTML code into the page, leaving an empty line above and below.

To colour some text

<span>colour this text</span>

Just add the above HTML code into the page, substituting the text to be coloured for "colour this text".

To hyperlink to one of your own pages

<a href="/my-page">my link text</a>

Just add the above HTML code into the page, substituting your filename for "my-page" and the required link text for "my link text".

To hyperlink to an external page

<a href="http://www.example.com/">link text</a>

Just add the above HTML code into the page, substituting the real page address for "http://www.example.com/" and the required link text for "link text".

Validating your HTML

Including a visitor tracking script

The default file /cms/inc/tracking.php is empty, but you can write your own visitor tracking script into the file. It should be noted that the relative path to the website root folder from this file is ../ because tracking.php is 'php included' from the /cms/inc folder directly into the /cms folder, one level below the root.

Additional notes

The CMS character set is UTF-8. There's a test page containing French, German, and Swedish characters, and other bits and pieces, validating as XHTML 1.0 Transitional.

CMS by Patrick Taylor

• home
• CMS changelog
• CMS help
• CMS info
• CMS installation
• HTML guide
• nikon sportstar ex
• thumbnail gallery
• contact