HTML CMS 2.0

Document structure

HTML CMS 2.0 is multilanguage content management system. Data of each language are stored in separate folders: EN, LT, UA, RU, etc.

The system builds several predefined chapters and data of each chapter are stored in predefined folders:

Each article are stored in separate folder with any unic name. Each news are stored in separate folder also, but each news directory name must be a date of a news writen in format YYYY_MM_DD.

Folder of each article must contain single HTML or TXT file of the adticle. The rules of this file format will be described later.

News, articles and blog can contain media data and photo gallery data. Each of this folders contains their media files and images of gallery in separate folders:

So the data structure may look like this:

EN
Announcements
Articles
ArticleName1
ArticleName1_files     (Illustrations for HTML article)
Gallery
Media
ArticleName1.htm    (HTML file of article)
ArticleName2
Gallery
Media
ArticleName2.txt     (TXT file of article)
Illustration001.jpg     (Illustration for text article)
Illustration002.jpg     (Illustration for text article)
Thumb.jpg     (Preview image for article)
Blog
NewsAndEvents
2017_11_15
2017_11_20
LT
Announcements
Articles
Blog
NewsAndEvents

Any name of unic file or folder must be written in Windows NT agreement or Linux agreement for names. For example the name "Slang Terms of the Seventies" must be written as:

SlangTermsOfTheSeventies

or

Slang_Terms_of_the_Seventies

All letters of name must be latin characters. Maximal length of name is 128 characters long.

Writing articles

Simple article is a file in *.txt format. You can write article with any text editor f. e. Windows Notepad.

When you save text file, select ANSI encoding. The ANSI *.txt file must be written in language that apropriate a languge of site chapter.

Before you start writing article prepare illustartion images for article. You can use ahy file name for it written with english letters without spaces. You can use Windows NT name agreement or Linux name agreement for names. Illustrations may be in *.jpg, *.gif or *.png format.

You wiould need one special preview image for article that would be displayed by nsvigation mechanisms of CMS. This image also may be in *.jpg, *.gif or *.png format, but it has a special reserved name "Thumb", for example "Thumb.jpg" or "Thumb.gif". This image may have any size, but it is better to create image with size of 92x92 pixels. Large images load slowlier, but it would work also.

After you had created images, write text article. The rules are next ones:

  1. First string of article is article title.
  2. Any separate paragraph is a one long string without any line breaks. Each line break means new paragraph.
  3. Any line shorter than 64 letters will be interpreted as title of article chapter.
  4. You can use any amount of line brakes.
  5. If you need to add illustration betwen two paragraphs, write name of file between paragraphs.
  6. You can use HTML markup for decoration, such as bold, italic, font size and color, etc.

Here is an article example:

Kate Beckinsale <- article title

                             article paragraph
Beckinsale has signed up to produce a film about the life of activist Erin Pizzey.

KateBeckinsaleActresses.jpg  <- article image

Novelist and screenwriter <- article subtitle

She has commissioned novelist and screenwriter Emma Forrest to write the film based on the life of Erin.

See also http://www.kbeckinsale.net/ <- article paragraph, containing http://
Article publication

After you had written article, go to your site structure using FTP client.

  1. Find folder with language of your article, for examle "EN" or "LT".
  2. Find chapter where the article would be placed, for examle "Articles" or "Blog".
  3. Create new folder with your article name in Windows NT or Linux name agreement, for examle "FemineAgainstPutin" or "Femine_against_Putin".
  4. Copy text file of your article, preview image and illustratiob to this folder.

That's all. Exaple of article structure is shown by picture in "Document structure" section.

Photo gallery

To create photo gallery you only need to create images for gallery.

As it was described before, use Windows NT or Linux name agreement for file names.

To publish gallery, create a new subfolder in article filder with "Gallery" name. You can use any name for photh gallery folder exept special HTML component folder with "_files" or ".files" postfix. Note: the name "Images" meay be reserved for future version of CMS, don't use it.

Copy all images to "Gallery" folder.

Media player list

Adding videos for article is very simple also.

Crate video file in compatible streaming video format, for example *.MP4 or *.WMV.

Rename file as described earlier in Windows NT or Linux name agreement, for example "AllThatSheWants_OfficialMusicVideo.mp4" or "All_that_she_wants_Official_music_video.mp4".

Create "Media" subfolder in article folder.

Copy video file to this subfolder. If you have several video files copy them to this subfolder too.

Metatags

Additional layout information may be aqssigned directly in article file.

Examples:

<title>This is a name of article</title>
<meta name="description" content="Here is a short notice of article">
<meta name="status" content="3">
<meta name="picture" content="Image01.jpg">
<meta name="picture" content="Image02.jpg">
...
<meta name="thumb" content="Image01.jpg">
Metadata in text files

Text files can contain metadata as well as html files. Values of text metadata is the same as it was described in "Metatags" section, but them are written in more simple form.

This values must be assigned in beginning of a text file before main content of article as one single string. This is an example of text metadata:

title: The title of project block and facebook publishing module
description: The text of description of project block and facebook publishing module.
target: Subtitle of project block
status: 4
picture: Image01.jpg
picture: Image02.jpg
picture: Image03.jpg
thumb: FacebookPublishingModule.jpg

Thumb value must follow pictures values. (It is last  value of header.)

Then the article follows, as usial.

Article title
Article subtitle

Text of first paragraph of the article.

Text of second paragraph of the article.

Image01.jpg

Text of third paragraph of the article.

And so on..