Difference between revisions of "Plasma:esHTML"

(Moved text from Korman:Journals into a dedicated page.)
 
m (Formatting fixes.)
Line 6: Line 6:
  
 
Here is a list of commands that will help you layout your Journal's text to your liking:
 
Here is a list of commands that will help you layout your Journal's text to your liking:
−
===== Typeface Appearance: =====
+
 
 +
===== Typeface Appearance =====
 
You can use any of the fonts that are available in your dat folder. You can adjust the size and the colour. The built-in font files in your dat folder have the file extension .p2f but that file extension is '''NOT''' required by the command.  
 
You can use any of the fonts that are available in your dat folder. You can adjust the size and the colour. The built-in font files in your dat folder have the file extension .p2f but that file extension is '''NOT''' required by the command.  
 
Use the font's  name '''only'''.  
 
Use the font's  name '''only'''.  
Line 21: Line 22:
 
  ''<''face=Courier font size=20 color=000000''>''  
 
  ''<''face=Courier font size=20 color=000000''>''  
 
to make the rest of the Journal's text black again.
 
to make the rest of the Journal's text black again.
−
===== Text alignment : =====
+
 
 +
===== Text alignment =====
 
You can have the text aligned to the left, centre or right of the page using the align command:
 
You can have the text aligned to the left, centre or right of the page using the align command:
 
   ''<''align=center''>''
 
   ''<''align=center''>''
−
===== Page margins : =====
+
 
 +
===== Page margins =====
 
This defines the border in pixels at which the text is written.
 
This defines the border in pixels at which the text is written.
 
IIRC, this works per-page and not per-line. Which means you cannot change the margin for a single line, but can change it for the full page.
 
IIRC, this works per-page and not per-line. Which means you cannot change the margin for a single line, but can change it for the full page.
 
   ''<''<margin left=62 right=62 top=48>''>''
 
   ''<''<margin left=62 right=62 top=48>''>''
−
===== Page Break : =====
+
 
 +
===== Page Break =====
 
This forces the Journal to make a new page for your text. For example, if you wanted each journal entry to appear on a new separate page.
 
This forces the Journal to make a new page for your text. For example, if you wanted each journal entry to appear on a new separate page.
 
   ''<''pb''>''
 
   ''<''pb''>''
 +
 
===== Appearance and Position of Images : (see also below) =====
 
===== Appearance and Position of Images : (see also below) =====
 
Images can be placed into your Journal along with the text (see below). To change their position and appearance in your Journal you can use these commands:
 
Images can be placed into your Journal along with the text (see below). To change their position and appearance in your Journal you can use these commands:
Line 39: Line 44:
 
A typical command for an image that has an alpha layer and you wish to appear in the centre of the page and with an addition transparency would be:
 
A typical command for an image that has an alpha layer and you wish to appear in the centre of the page and with an addition transparency would be:
 
   ''<''<img src="yourimage.hsm" opacity=0.7 align=center blend=alpha>''>''
 
   ''<''<img src="yourimage.hsm" opacity=0.7 align=center blend=alpha>''>''
−
===== Closed Book cover : (see also below) =====
+
 
 +
===== Closed Book cover =====
 
If you want your Journal to first display as a closed book then you must put a cover image in your image library (see below)
 
If you want your Journal to first display as a closed book then you must put a cover image in your image library (see below)
 
To show the cover you need to start your Journal's text file with the following command:
 
To show the cover you need to start your Journal's text file with the following command:

Revision as of 18:19, 1 August 2020

Plasma esHTML

Making a journal by simply writing text in a file is ok, but there are a several options available to change the layout and appearance of your Journal's content. These can altered by adding tags (Plasma's version of HTML code) within the text of your Journal. These tags do not need to be in any particular order and their effect will apply to all the text that appears after them until there is a new command to change it. These tags are always placed inside angle brackets ( < > ). The single set of these brackets can contain as many commands as you like, but remember, all the text that appears after those brackets will be affected by those commands.

Here is a list of commands that will help you layout your Journal's text to your liking:

Typeface Appearance

You can use any of the fonts that are available in your dat folder. You can adjust the size and the colour. The built-in font files in your dat folder have the file extension .p2f but that file extension is NOT required by the command. Use the font's name only. For example, if you want to use the Courier font at size 20 and have it displayed in red then the code to put in your text file would be: 

 <face=Courier font size=20 color=ff0000>
font colour is the hexadecimal code you will find in your graphics program when you use the colour picker

Remember, ALL the text in your file that comes AFTER this command will be formatted this way until you use a new command to change it. You can add new commands at any time during your Journal's text.

For example, if you wanted most of your text to be black (000000) and just one word in red, then you would put 

<face=Courier font size=20 color=000000>

at the beginning of your Journal's text and then, before the word you wanted in red you would add 

<face=Courier font size=20 color=ff0000>

and then, immediately after that word, you would put 

<face=Courier font size=20 color=000000>

to make the rest of the Journal's text black again.

Text alignment

You can have the text aligned to the left, centre or right of the page using the align command: 

 <align=center>
Page margins

This defines the border in pixels at which the text is written. IIRC, this works per-page and not per-line. Which means you cannot change the margin for a single line, but can change it for the full page. 

 <<margin left=62 right=62 top=48>>
Page Break

This forces the Journal to make a new page for your text. For example, if you wanted each journal entry to appear on a new separate page. 

 <pb>
Appearance and Position of Images : (see also below)

Images can be placed into your Journal along with the text (see below). To change their position and appearance in your Journal you can use these commands:

  • img src = (see below for more information on this)
  • opacity = How transparent you want the image to be on the page
  • blend = If your image has an alpha layer you must choose "alpha" in order for the alpha to show. This is useful for things like images that you want to look like they have been sketched into the Journal.
  • align = how you want it aligned on the page

A typical command for an image that has an alpha layer and you wish to appear in the centre of the page and with an addition transparency would be: 

  <<img src="yourimage.hsm" opacity=0.7 align=center blend=alpha>>
Closed Book cover

If you want your Journal to first display as a closed book then you must put a cover image in your image library (see below) To show the cover you need to start your Journal's text file with the following command: 

<cover src="yourcover.hsm">

where "your cover.hsm" is the name of your cover image file in the image library.

If you fail to include this command in your Journal text file then the Journal will first appear as open, even if you have selected the "closed" option in the modifier.