First make sure that you are logged in to the Upendo website with your Upendo website account. If you are logged in then the User Menu block in the right sidebar will show the menu items "My Account" and "Log out":
In the Navigation menu block in the right sidebar, click on Add content:
The website shows a list of Content Types which you can create. Click on "Article":
The browser will display the new empty Article ready for your input:
Click into the Title field and enter a Title for the new Article.
Please use "Title Case" which means use a capital letter for all the major words but not the less important words like "and" "the" "of" unless they are the first word of the Title.
Do not use a full stop at the end of the Title.
The Image field is used to store a photo which is displayed as a thumbnail in the summary listing of the Article and at the top left of the full listing of the Article. It is good practice to add an Image but is not compulsory. The image adds interest to an Article and makes the summary of the Article visually interesting in a list of Articles.
To add an Image first make sure you have the Image available on the local computer (in My Documents, My Pictures, the Pictures library, any USB-connected device such as a camera or USB thumb drive, etc.). The image does not have to be down-sized before uploading as the uploading process will do that for you.
Click on Choose File:
and browse on the local computer to the required Image. Click to select it and then click Open:
Then click on Upload:
and wait for the uploading process to complete: the thumbnail image will display:
Add some Alternate text describing the image to help screen readers, search engines, or when the image cannot be loaded.
Note the information about the Allowed file types: png gif jpg jpeg
The statement that "Images must be smaller than 500x500 pixels" is not strictly true: any Image which has either dimension greater than 500 pixels will be automatically re-sized (while maintaining the aspect ratio of the image) during to the uploading process so that its longer dimension is 500 pixels. This is a convenient way to downsize a larger file (perhaps straight from a digital camera) without the need for any local processing. However, the whole of the larger file must be uploaded to the Upendo website so this can take longer on slower Internet connections.
By default the Upendo website will use the first 150 characters of the Body of an Article as the basis for a Summary of the Article. If you want to override this, shorten it, or supply an alternative Summary then click on the link Edit summary here:
The page now reveals the separate Summary field into which you can paste text from the body and edit it or type some alternative text.
Click into the Body field to create the Body of the Article.
You can either just type the Body of your new Article or Copy and Paste text into the Body field from a saved document prepared beforehand. However, please do not paste in the fully formatted text straight from the document. It will be full of hidden non-HTML formatting instructions which will make a mess of your article. Instead do one of the following:
- Paste your text into the Body of the Article using the Paste as plain text button on the editor toolbar:
You will probably see this dialogue box which wants you to paste the text into it:
Do so and click OK. The text without its formatting is pasted into the Body field.
- Launch the Notepad program if you are on a Windows computer.
Paste the text into Notepad which will automatically remove all formatting.
Select all the text (Control+A)
Copy the unformatted text back onto the Clipboard (Control+C)
Paste the unformatted text straight into the Body field (Control+V)
You can now use the buttons on the editor to format text, add an inline Image (photo), insert a Table, and create a Link.
[toggle title="Heading Style"]
Select text which you want to display as a Heading and choose a Heading Style from the drop down list:
Heading Styles run from "Heading 1" down to "Heading 6".
"Heading 1" is the top Heading Style and is used for the Title of a page on the Upendo website. It should not therefore be used inside the Body of an Article.
[toggle title="Bold Text"]
Select text which you want to display as Bold type and click B:
[toggle title="Italic Text"]
Select text which you want to display as Italic type and click I:
[toggle title="Underline Text"]
Select text which you want to display as Underlined type and click U:
[toggle title="Numbered List"]
The better way to create a numbered list is to switch on the numbering before you start typing. So, click:
and then type your first item in the list. Press Enter and type the second item, etc. When you have typed your last numbered item, press Enter - you see a new numbered item start - and press Enter again and formatting will return to Normal without numbering.
If you have already typed the text then select those paragraphs which you want to display as a numbered list and click:
[toggle title="Bulleted or Un-numbered List"]
The better way to create a bulleted or un-numbered list is to switch on the bullets before you start typing. So, click:
and then type your first item in the list. Press Enter and type the second item, etc. When you have typed your last bulleted item, press Enter - you see a new bulleted item start - and press Enter again and formatting will return to Normal without bullets.
If you have already typed the text then select those paragraphs which you want to display as a bulleted list and click:
[toggle title="Indented Text"]
Select text which you want to Indent and click:
This will indent the text half an inch. Click again for another half an inch, etc.
If you have overdone the indenting then the Un-indent button (with the arrow pointing to the left) will reduce the indenting of the selected text by half an inch.
[toggle title="Centre Aligned Text"]
Select text which you want to centre align and click:
[toggle title="Right Aligned Text"]
Select text which you want to right align and click:
Add an Inline Image in the Body Field
Images can be added as Inline Images in the Body of the article. These add interest to the Article and allow more images to be used than just the single image allowed in the Image Field.
Note that the image already uploaded for the Image field can be used again in the Body of the article as an Inline Image. If it is the only image available then this fine. If there are other images available then don't re-use the one which has already been used in the Image field.
The easiest way to position an Inline Image is in its own paragraph with a paragraph of text above and (optionally) a paragraph of text below. So, create a blank paragraph by pressing Enter and make sure the cursor is positioned there.
On the editor toolbar click the Image button:
and, on the dialogue box that appears, click the Browse Server button:
The CKFinder window will now open allowing you to browse for existing images or to upload a new Inline Image:
[toggle title="Use the Image Field image"]
If you want to use the image that you just uploaded to the Image Field then browse until you find it and then double-click to use it. That will take you back to the "Browse Server" dialogue box.
[/toggle] [toggle title="Use an existing image on the website"]
If you want to use an existing image already on the website then browse to it and see what versions of it are available: the name of the various versions of the image may have different suffices like "_0" and "_large". If you can't see all of the filename then just hover your mouse over the image and the computer will show you the full filename. The one you need for an Inline Image is _large which means it has been re-sized to a maximum of 500 pixels in either dimension (just like the image uploaded to the Image Field). Double-click to use it. That will take you back to the "Browse Server" dialogue box.
[/toggle] [toggle title="Use a new image"]
If you want to upload a new Inline Image then first make sure you have the Image available on the local computer (in My Documents, My Pictures, the Pictures library, any USB-connected device such as a camera or USB thumb drive). The image does not have to be down-sized before uploading as you can use the CKFinder window to do that for you.
Click on Upload on the toolbar at the top of the CKFinder window:
The CKFinder window now shows buttons for Add Files and Close. Click on Add Files:
and browse on the local computer to the required Image. Click to select it and then click Open:
CKFinder will immediately begin to upload the file and show progress bars to indicate that. When the upload is complete then you need to create the _large version having a maximum dimension of 500 pixels. Browse to the newly uploaded image and right-click:
Click on Resize and the Resize dialogue box will appear. It shows you a thumbnail of the image and, below it, the pixel dimensions of the image. You want to create a Large (500x500) version of the Image so tick the box next to that option:
Click OK and CKFinder will create the new _large version. CKFinder always refreshes its display so you must browse again to find the required image. Make sure you locate the newly created _large version. Double-click to use it. That will take you back to the "Browse Server" box.
Whatever the source of the Inline Image (the Image Field image, existing _large file on the website, new Inline Image just uploaded) be sure to delete the Width and Height numbers to make the image "responsive" to the browser window size.
If you delete one of the Width or Height then the other will disappear also.
Finish the process: click on OK:
The image is inserted inline on the paragraph where the cursor was sitting.
If you decide you have chosen the wrong image then just click once on the image to select it, press Delete on the keyboard, and start the whole process over again.
[/toggle] [toggle title="Insert a Table"]
A Table is a good way to display structured information in rows and columns.
Always position a Table in its own paragraph. So, create a blank paragraph by pressing Enter and make sure the cursor is positioned there.
On the editor toolbar click the Table button:
The Table Properties dialogue box appears:
Set the number of rows and columns required for your Table. Leave the rest of the properties at their default settings.
[/toggle] [toggle title="Create a Link"]
A Link (or more properly a Hyperlink) is a piece of text that you can click on to take you to another page on this website or another website. Use a Link to help readers of the Upendo website easily navigate to another webpage.
First, make sure you know the exact URL (the website address) of the destination of the hyperlink. Better still, use another tab on your browser to navigate to that destination page, click in the Address Bar and copy the exact URL onto the Clipboard.
Back on the tab where you are creating the new Article, select the text that is going to become a Link.
On the editor toolbar click the Link button:
The Link dialogue box appears:
Paste (Control+V) or type the exact URL into the URL field. The computer will strip out the leading "http://" as that is already shown as the default protocol for the link.
When you have completed and saved the new Article be sure to test out your new Link to make sure it works as expected.
Leave the Text format set to "Filtered HTML" unless you have good reason to change it.
Save your Changes
Scroll down to the bottom of the browser page and click the button.
Finally, log out of the Upendo website using the "Log out" menu on the User Menu in the right sidebar: