Tutorial: Adding an Article To the CMS

You have researched your topic, written your article, and your Editor has approved. Now it is time to create a wiki and add your document to the site CMS. The following process will ensure your success in publishing your article. Read this tutorial thoroughly before beginning and reference it as needed throughout the process.

Creating a New Wiki

When you log in, you will arrive at your HUB screen. The left-hand side of the screen contains a menu that will allow you to access the required areas of the site. Select the "CREATE WIKI ARTICLE" button midway through the list.



Selecting this article will open the modal into which you input the information for your document.


Before continuing, ensure you are using the correct modal by referencing the top left corner of the screen. The word "Article" will appear here. If the top left corner of the modal says something else (e.g., Journal, Documentation, etc.) you are not in the correct area of the website.



Understanding the Sections of the Modal

Your document information must be entered into the correct sections of the modal to display on the website correctly. The details of these sections are as follows:

  • Title: the "Title" will become the URL of your document the first time you click save, so it must be accurate and correct (Check the spelling!).
  • Context: this is the area into which you enter the body of your document
    • Copy/Paste is available for entering data here. Formatting will likely be required and is covered below.
  • Project: open the dropdown and select "Content Writer Operations"
  • Role: open the dropdown and select "Writer"
  • Status: open the dropdown and select "Editing"
  • Member: your name should already appear in this dropdown - if not select it
  • Editing: nothing should be selected
  • Media Uploader: this is where you will upload the image that will replace the GURU logo as the thumbnail for your article on the website
  • Short Snippet Teaser: here you will enter the short answer to the question asked in your topic
    • Entering a snippet longer than 250 characters will produce an error. This error can be avoided by ensuring you count the characters in advance. Because spaces, as well as letters, count toward overall character count, we recommend using Letter Count.
  • Tags or Keywords: enter keywords separated by commas
  • Reference: copy/paste the URL of your references into this section and format as instructed below
  • Category: click the Content Writer checkbox


Suggestions to Fight Formatting Frustration

Upon creating a new wiki, we recommend that you input the title of your document into the "Title" section and save it before going further in the process. It is imperative to doublecheck the title you have entered before saving. Taking this simple step before continuing will prevent instances in which you spend a significant amount of time formatting your wiki only to have an error occur, preventing the data from being stored. 

Once the wiki is saved, you can re-open it and continue to add information. The initial modal will show the areas that require data, but none of the editing tools you have come to expect from a word processor. Scroll down to the bottom of the modal and click the "Editor" button to gain access to these options.  *WARNING* If you enter information into the Context, Short Snippet Teaser, or References areas before selecting the Editor button, the text you have entered will lose all formatting. To avoid losing formatting information, select the Editor button before entering any data into the modal.


Once selecting the Editor button, the options will become available in all relevant areas of the modal. 



Now you have access to the editing tools you can proceed with entering the data for your document.


Steps To Format Headings

There is a dropdown called "Formats" in the editing tools of the wiki (Not to be confused with the "Format" dropdown in the toolbar that is available with or without the Editor activated.) that will let you designate your headings. The "Title" entered previously will always be "Heading 1", which is equivalent to an <h1> tag. The headings in the body of your paper will start with "Heading 2', which is equivalent to an <h2> tag. To designate your headings, highlight the text and select the dropdown as shown below. Nested headings progress as logically expected and are available down to "Heading 6". 


File • Edit. View • Inset • 
ormats • 
Format • Tools - 
Table • 
Heading I 
Heading 2 
Heading 3 
Heading 4 
Heading 5 


Steps To Format References

Formatting references begins when you copy/paste the URLs for your references into the appropriate section of the wiki. Highlight the reference link then click the Insert/edit link button in the toolbar.



When the modal pops up, type the title of your reference article in the "Text to display" section and press "Ok".


After you press "Ok", the text displayed in the Reference section will be the text you entered while the link remains intact. 


It is crucial that you enter the title of the article in both areas in order to ensure accessibility to those using the internet through assistance devices. Please be sure you are entering the title of your reference article and not the name of the website.

Adding Media

The first image you add to your article must appear within the first 500 words. At least one image needs to be toward the top to help grab the attention of the audience. With this in mind, please choose an eye-catching image. Adding images to the body of your article can be done with a copy/paste feature. Likely, your images will not transfer over with the text when you copy/paste the entirety of your article. Images can be selected individually, copied, then pasted to the correct location in the wiki using the ctrl + v keystrokes.



Add a thumbnail to your article by using the Media Uploader button located toward the center of the wiki. Clicking the button will bring up a modal that will allow you to choose an image from your computer and upload it as an asset to your wiki. You cannot copy/paste the thumbnail. The image must be saved as an image (.jpeg or .png) on your computer or in a reachable cloud location.


Upload Asset - Google Chrome 
uter. Da 
ou are 
Choose File No file chosen 
le to avc 
ment pr 


Click the "Choose File" button and navigate to the location of the image you want to upload. 


Organize • 
> This PC 
New folder 
Dad GoFundMe 
Why do 
Computers use 
Search Desktop 
All Files ff.") 
* Quick access 
content writers 
State of KS 
This pc 
3D Objects 
[E Pictures 
Windows (c:) 
Data (D:) 
File name: brokenLaptopScreen.png 


Once you click "Open," you will be back to the modal. You should see the name of your selected image.


Choose File brokenLaptopScreen_png 


Confirm the name of the image is correct and click "Upload".


Upload Asset - Google Chrome 
Upload Completed 
You can close this window now, Allow 
30 seconds for the new asset to show 
up in the content page.


This text indicates the upload was successful. When returning to the wiki, you should see that every location that once displayed the GURU Solutions logo now displays the image you just uploaded. A preview of the image will also be shown next to the media uploader.


Copy/Paste Image Properties

After pasting the image, you will need to select it and click the Insert/edit image button on the editor toolbar.

A modal will pop up that will allow you to fill in the description of the image. It is essential to keep the website accessible to those using the internet through assistance devices. The description does not need to be long or elaborate.

Enter your description and click "Ok".

**These steps should be taken with all images to ensure that an image description is available for devices such as screen readers that assist those who cannot access the internet on their own.