Difference between revisions of "Wiki Editing CheatSheet"

From SmartWiki
Jump to: navigation, search
(→‎Image Files)
(→‎Links to External Pages)
 
(110 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
This page is intended to assist editors of the SmartSimple Wiki make revisions and additions.
+
=Overview=
 +
SmartSimple’s Wiki is a repository of knowledge targeted at system Administrators intended to help make learning and configuring easier. This page will provide guidance for anyone who is contributing to the wiki. Following established standards will improve the user experience of this Wiki. All new articles should follow the template found in google drive > shared drives > Wiki project or look at the below. For statistics you can look at the dashboards and https://wiki.smartsimple.com/wiki/Special:SpecialPages
  
−
'''Remember these basic best practices for building your Wiki page:'''
+
==Wiki article structure==
−
* [http://www.bartleby.com/141/strunk5.html Make it brief.]
+
All wiki articles should follow this format:
−
* Add [[Wiki_Editing_CheatSheet#Hyperlinks|hyperlinks]] to other pages where SmartSimple's terminology is used. 
 
−
* Add an [[Wiki_Editing_CheatSheet#Image_Files|image]] of the subject(s) of the article.
 
−
* Add a "[[Arcadia_-_Level_1_Summary_(matrix)_Settings#See_Also|See Also]]" section with related articles that may or may not have been mentioned in the text.
 
−
* Put your page under one or more [[Wiki_Editing_CheatSheet#Categories|Categories]].
 
  
−
----
+
===Overview===
 +
Answer the following questions
 +
 
 +
# What is this article about? Example: The Login page allows a user to gain access to your SmartSimple System. The user will authenticate on this page, typically by entering a username and password.
 +
# Why is this important? Example: The login page is used to: Authenticate the user, Switch languages, Direct people to a signup page, Ask the user to accept the use of cookies, enforce agreement of your systems privacy and security policies, and Reset your password.
 +
# What will the reader learn from this article? Example: This article will show you how to setup and modify login pages within your system.
 +
# Is there anything odd or important that should be noted? Example: Note: You will need global administrator access to setup or edit login pages. You will also need to create a separate login page for each language you want to support.
 +
 
 +
===Configuration – Essentials===
 +
Break out all the tasks the majority of users will do and explain how to do them in the minimal steps possible. Use a numbered list for the tasks and keep them below 15 steps. If it is more than 15 steps to do something, break the task into multiple headers.
 +
 
 +
===Configuration - Advanced===
 +
Break out all other tasks not listed in the essentials section. This section is meant for tasks that are particularly difficult, not commonly used or tricky/cumbersome.
 +
 
 +
===Settings Explained===
 +
List all the settings used by this page/feature, what the setting does and if not self evident why you would use it. This should be presented in a table format. In time this may be replaced by an in system help.
 +
 
 +
===Category===
 +
Make sure every article has a category. This way it is easy to find all related pages. Ideally all articles should be in one of the categories found on the home page https://wiki.smartsimple.com/wiki/Main_Page. This way anyone entering the wiki for the first time can find all the good articles. If an article falls into more than one category that is ok.
 +
 
 +
===Other considerations===
 +
* Use US English for spelling.
 +
* Use [https://docs.microsoft.com/en-us/style-guide/procedures-instructions/formatting-text-in-instructions Microsoft conventions] for writing instructions (When you refer to a button, check box, or other option, use bold formatting for the name)
 +
 
 +
{| class="wikitable"
 +
|-
 +
||Correct
 +
||Select '''Save'''
 +
|-
 +
||Incorrect Select
 +
||"save"
 +
|}
 +
 
 +
Note more help about the mediawiki can be found [https://www.mediawiki.org/wiki/Help:Contents mediawiki.org]
  
 
==Text Formatting==
 
==Text Formatting==
 +
===Bullets===
 +
Create bullets like an unordered-list
  
−
===* Bulleted Text===
+
* Bullet 1
 +
* Bullet 2
  
−
* Bulleted Text
+
<pre>* Bullet 1
 +
* Bullet 2
 +
</pre>
  
 
==='''Bold Text'''===
 
==='''Bold Text'''===
 +
'''Bold Text'''
  
−
<nowiki>'''Bold Text'''</nowiki>
+
<pre>'''Bold Text'''</pre>
  
 
===''Italicized Text''===
 
===''Italicized Text''===
 +
''Italicized Text''
  
−
<nowiki>''Italicized Text''</nowiki>
+
<pre>''Italicized Text''</pre>
  
 
===Adding<sup>Superscript</sup>===
 
===Adding<sup>Superscript</sup>===
−
<nowiki><sup>superscript</sup></nowiki>
+
text<sup>superscript</sup>
 +
 
 +
<pre>Text<sup>superscript</sup></pre>
  
 
===Adding<sub>Subscript</sub>===
 
===Adding<sub>Subscript</sub>===
−
<nowiki><sub>subscript</sub></nowiki>
+
Text<sub>subscript</sub>
 +
 
 +
<pre>Text<sub>subscript</sub></pre>
  
 
===#Numbered...===
 
===#Numbered...===
−
#...Series
+
# Item
 +
# Item
 +
# Item
 +
# Item
  
−
<nowiki>#Numbered...</nowiki>
+
<pre># Item
−
<nowiki>#...Series</nowiki>
+
# Item
 +
# Item
 +
# Item</pre>
  
 
===Preformatted text===
 
===Preformatted text===
 +
You can have HTML or WIKI syntax appear the way you typed it by wrapping the code with an opening '''<''' and '''pre''' and '''>''' then a closing '''<''' '''/''' '''pre''' and '''>''' tag. This is used for code examples of what to type into the wiki. The pre stands for preformatted text. This will preserve the formatting of the text you entered (example tab, double spaces, new lines). Currently you cannot add code that has a closing tag < / > inside a pre as the slash will close the pre. We have tried other syntax such as nowiki and code but they all seem to exhibit the same issues after you save, edit then save again. The pre tag is not to be used for emphasis or notes.
  
−
Use <nowiki><pre></pre></nowiki> tags.<br>
+
<pre>your code goes here
−
In order to use word wrapping, use the following: <br>
+
double space  double space
−
<nowiki><pre style="white-space: pre-wrap;
+
tab tab tab
−
white-space: -moz-pre-wrap;
+
</pre>
−
white-space: -pre-wrap;
 
−
  white-space: -o-pre-wrap;
 
−
word-wrap: break-word;">
 
−
This long sentence is used to demonstrate text wrapping. This additional sentence makes the text even longer.
 
−
</pre></nowiki>
 
−
 
 
−
For more info, go to [http://www.mediawiki.org/wiki/Help:Formatting MediaWiki Help: Formatting]
 
  
 
==Heading Levels==
 
==Heading Levels==
−
<nowiki>== Level 2 ==
+
Level 1 is for page name.
−
=== Level 3 ===
 
−
==== Level 4 ====
 
−
===== Level 5 =====
 
−
====== Level 6 ======</nowiki>
 
−
 
 
−
*Level 1 is the Page Name.
 
−
*An article with four or more headings automatically creates a [[Wiki_Editing_CheatSheet#Tables_of_Contents|table of contents]].
 
  
−
For more info, go to [http://www.mediawiki.org/wiki/Help:Formatting MediaWiki Help: Formatting]
+
<pre>==level 2==
 +
===Level 3===
 +
====Level 4====
 +
=====Level 5=====
 +
======Level 6======
 +
</pre>
  
 
==Tables of Contents==
 
==Tables of Contents==
−
MediaWiki adds a table of contents at the top of the page when you have four or more [[Wiki_Editing_CheatSheet#Heading_Levels|headers]].<br>
+
MediaWiki adds a table of contents at the top of the page when you have four or more [[Wiki_Editing_CheatSheet#Heading_Levels|headers]].<br />
 
To change this behavior, at the top of the page, add:
 
To change this behavior, at the top of the page, add:
−
<nowiki>__NOTOC__</nowiki> Hides the table of contents (TOC).
 
−
<nowiki>__FORCETOC__</nowiki>    Forces the table of contents to appear at its normal position (before the first header).
 
−
<nowiki>__TOC__</nowiki> Places a table of contents at the word's current position (overriding <nowiki>__NOTOC__</nowiki>).
 
  
−
For more info, go to [http://www.mediawiki.org/wiki/Manual:Table_of_contents MediaWiki Manual: Table of contents] or [http://www.mediawiki.org/wiki/Help:Magic_words MediaWiki Help: Magic words]
+
<pre>__NOTOC__ Hides the table of contents (TOC).
 +
__FORCETOC__    Forces the table of contents to appear at its normal position (before the first header).
 +
__TOC__ Places a table of contents at the word's current position (overriding <nowiki>__NOTOC__).
 +
</nowiki></pre>
  
 
==Hyperlinks==
 
==Hyperlinks==
 +
===Links to Internal Pages===
 +
Link to internal page
  
−
===Links to Internal Pages===
+
[[Branding]]
−
To add a link to '''Main Page''':
+
 
−
<nowiki>[[Main Page]]</nowiki>
+
<pre>[[Branding]]</pre>
 +
 
 +
Link to internal page with different text
 +
 
 +
[[Branding|Different text]]
 +
 
 +
<pre>[[Branding|Different text]]</pre>
 +
 
 +
Link to a heading on the same page
 +
 
 +
[[#Heading Levels|Heading Levels]]
  
−
To add a link to '''Main Page''' which displays as ''different text'':
+
<pre>[[#Heading Levels|Heading Levels]]</pre>
−
<nowiki>[[Main Page|</nowiki>''different text''<nowiki>]]</nowiki>
 
  
 
===Links to External Pages===
 
===Links to External Pages===
−
To add a link to www.smartsimple.com
+
Add a link to an external webpage
−
<nowiki>http://www.smartsimple.com</nowiki>
 
  
−
To add a link to www.smartsimple.com with a ''different label''
+
[https://www.smartsimple.com smartsimple.com]
−
<nowiki>[http://www.smartsimple.com</nowiki> ''different label''<nowiki>]</nowiki>
 
  
 +
<pre>[https://www.smartsimple.com smartsimple.com]</pre>
  
−
<pre style="white-space: pre-wrap;
 
−
white-space: -moz-pre-wrap;
 
−
white-space: -pre-wrap;
 
−
white-space: -o-pre-wrap;
 
−
word-wrap: break-word;">Note: All external links are currently set to open in a new window.</pre><!--Chin can change this if necessary (apparently using syntax from https://www.mediawiki.org/wiki/Manual:$wgExternalLinkTarget)-->
 
  
 +
Note:
  
−
For more info, go to [http://www.mediawiki.org/wiki/Help:Links MediaWiki Help: Links]
+
* You must specify text for the link or it will show up as a number.
 +
* All external links open in a new window.
 +
 
 +
===Email Links===
 +
 
 +
[mailto:sales@smartsimple.com sales@smartsimple.com]
 +
 
 +
<pre>[mailto:sales@smartsimple.com sales@smartsimple.com]</pre>
  
 
==Image Files==
 
==Image Files==
−
# Under the '''toolbox''', click '''Upload file'''.
+
# Under the '''Global Actions''', press '''Upload file'''.
−
# Upload the image.
+
# Press the '''Choose File''' button to select an image and press '''Open'''.
−
# On the page you wish to display the image: enter this format:
+
# Press the '''Upload File''' button
 +
 
 +
Note:
 +
When adding screenshots, they should be approximately 1280 pixels wide and displayed at 800 pixels wide.
 +
When naming images, it is suggested to use the ticket number dash year dash number. That way it is easy to identify the related enhancement ticket and to see if the screenshot is out of date.
 +
 
 +
 
 +
To display an image
 +
[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|800px|The four disability classifications]]
 +
 
 +
<pre>[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|800px|The four disability classifications]]</pre>
 +
 
 +
Images are uploaded at a resolution of 1280 pixels but displayed at 800px.
 +
Make sure you add a caption.
  
−
===Image no link with caption===
 
−
<nowiki>[[File:imgname.png|thumb|none|500px|Caption for under the image]]</nowiki>
 
  
−
===Image linked to external link===
+
Image with internal link
−
<nowiki>[[File:Who-is-using-btn.png|330px|link=http://www.smartsimple.com/collaborators-online.html]]</nowiki>
+
[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|link=Accessibility|800px|The four disability classifications]]
  
−
===Image linked to internal link===
+
<pre>[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|link=Accessibility|800px|The four disability classifications]]</pre>
−
<nowiki>[[File:thumbnail-blue-white.jpg|400px|link=Blue and White]]</nowiki>
 
  
−
For more info, go to [http://www.mediawiki.org/wiki/Help:Images MediaWiki Help: Images]
+
Image with external link
 +
[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|link=https://www.smartsimple.com/agreements.html|800px|The four disability classifications]]
  
−
==Tables==
+
<pre>[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|link=https://www.smartsimple.com/agreements.html|800px|The four disability classifications]]</pre>
−
===Syntax===
 
−
<table class="wikitable" width="60%">
 
−
<tr>
 
−
<td style="padding: 10px;"><big>{|</big></td>
 
−
<td style="padding: 5px;"><b>table start</b></td>
 
−
</tr>
 
−
<tr>
 
−
<td style="padding: 10px;"><big>|+</big></td>
 
−
<td style="padding: 5px;">table <b>caption,</b> <i>optional;</i> only between <b>table start</b> and first <b>table row</b></td>
 
−
</tr>
 
−
<tr>
 
−
<td style="padding: 10px;"><big>|-</big></td>
 
−
<td style="padding: 5px;"><b>table row,</b> <i>optional on first row</i> -- wiki engine assumes the first row</td>
 
−
</tr>
 
−
<tr>
 
−
<td style="padding: 10px;"><big>!</big></td>
 
−
<td style="padding: 5px;"><b>table header</b> cell, <i>optional.</i> Consecutive <b>table header</b> cells may be added on same line separated by double marks (<code>!!</code>) or start on new lines, each with its own single mark (<code>!</code>).</td>
 
−
</tr>
 
−
<tr>
 
−
<td style="padding: 10px;"><big>|</big></td>
 
−
<td style="padding: 5px;"><b>table data</b> cell, <i>required!</i> Consecutive <b>table data</b> cells may be added on same line separated by double marks (<code>||</code>) or start on new lines, each with its own single mark (<code>|</code>).</td>
 
−
</tr>
 
−
<tr>
 
−
<td style="padding: 10px;"><big>|}</big></td>
 
−
<td style="padding: 5px;"><b>table end</b></td>
 
−
</tr>
 
−
</table>
 
  
−
===Example===
+
You can upload a new version of any file by typing '''File:''' then your desired file name into the search.
  
−
This...
+
==Other Files==
 +
You can also upload files such as a zip file by entering the following and if it does not exist click on the link to upload the file:
  
−
<nowiki>{| border="1"</nowiki>
+
[[File:website-portal-sample-images.zip]]
−
<nowiki>|'''Menu or Application'''</nowiki>
 
−
<nowiki>|'''Search For'''</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Organization, Search People</nowiki>
 
−
<nowiki>|People: internal and external, related companies, standard and custom fields.</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Communications, Contacts</nowiki>
 
−
<nowiki>|External people only - limited search capabilities.</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|[[Universal Tracking Application]] > Contact Tab</nowiki>
 
−
<nowiki>|Same page as the ''Search People'' page.</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|[[Universal Tracking Application]] > Company Tab</nowiki>
 
−
<nowiki>|Same functionality as the ''Search People'' page, but with companies.</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Sales Tracking Application > Company Tab</nowiki>
 
−
<nowiki>|Same page as the Company tab in the [[UTA]]</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Sales Tracking Application > Contacts Tab</nowiki>
 
−
<nowiki>|Same page as the ''Search People'' page</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Sales Tracking Application > My Contacts</nowiki>
 
−
<nowiki>|Limited to contacts associated with companies where the current user is the owner.</nowiki>
 
−
<nowiki>|}</nowiki>
 
  
−
...produces this...
+
<pre>[[File:website-portal-sample-images.zip]]</pre>
  
−
{| border="1"
+
==Tables==
−
|'''Menu or Application'''
+
===Syntax===
−
|'''Search For'''
+
{| class="wikitable"
 
|-
 
|-
−
|Organization, Search People
+
!|Syntax
−
|People: internal and external, related companies, standard and custom fields.
+
!|Description
 
|-
 
|-
−
|Communications, Contacts
+
||
−
|External people only - limited search capabilities.
+
<pre>{|</pre>
 +
||'''table start'''
 
|-
 
|-
−
|[[Universal Tracking Application]] > Contact Tab
+
||
−
|Same page as the ''Search People'' page.
+
<pre>|+</pre>
 +
||table '''caption,''' optional; only between '''table start''' and first '''table row'''
 
|-
 
|-
−
|[[Universal Tracking Application]] > Company Tab
+
||
−
|Same functionality as the ''Search People'' page, but with companies.
+
<pre>|-</pre>
 +
||'''table row,'''
 
|-
 
|-
−
|Sales Tracking Application > Company Tab
+
||
−
|Same page as the Company tab in the [[UTA]]
+
<pre>!|</pre>
 +
||'''table header'''
 
|-
 
|-
−
|Sales Tracking Application > Contacts Tab
+
||
−
|Same page as the ''Search People'' page
+
<pre>||</pre>
 +
||'''table data''' each cell
 
|-
 
|-
−
|Sales Tracking Application > My Contacts
+
||
−
|Limited to contacts associated with companies where the current user is the owner.
+
<pre>|}</pre>
 +
||'''table end'''
 
|}
 
|}
  
−
===Example of Aligning Text===
+
===Example===
−
 
+
{| class="wikitable"
−
This...
 
−
 
 
−
<nowiki>{|</nowiki>
 
−
<nowiki>! align="left"| Item</nowiki>
 
−
<nowiki>! Amount</nowiki>
 
−
<nowiki>! Cost</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Orange</nowiki>
 
−
<nowiki>|10</nowiki>
 
−
<nowiki>|7.00</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>|Butter</nowiki>
 
−
<nowiki>|1</nowiki>
 
−
<nowiki>|5.00</nowiki>
 
−
<nowiki>|-</nowiki>
 
−
<nowiki>!Total</nowiki>
 
−
<nowiki>|</nowiki>
 
−
<nowiki>|12.00</nowiki>
 
−
<nowiki>|}</nowiki>
 
−
 
 
−
...produces this...
 
−
 
 
−
{|
 
−
! align="left"| Item
 
−
! Amount
 
−
! Cost
 
 
|-
 
|-
−
|Orange
+
!|Sample Header
−
|10
+
!|Sample Header
−
|7.00
 
 
|-
 
|-
−
|Butter
+
||Sample Text
−
|1
+
||Sample Text
−
|5.00
 
 
|-
 
|-
−
!Total
+
||Sample Text
−
|
+
||Sample Text
−
|12.00
 
 
|}
 
|}
  
−
For more info, go to [http://www.mediawiki.org/wiki/Help:Tables MediaWiki Help: Tables]
+
<pre>{| class="wikitable"
 +
|-
 +
!|Sample Header
 +
!|Sample Header
 +
|-
 +
||Sample Text
 +
||Sample Text
 +
|-
 +
||Sample Text
 +
||Sample Text
 +
|-
 +
|}
 +
</pre>
  
 
==Categories==
 
==Categories==
 +
You can categorize pages and files by adding one or more Category tags to the content text. These tags create links at the bottom of the page that take you to the list of all pages in that category, which makes it easy to browse related articles.
  
−
===Adding a Category to a Page===
+
<pre>[[Category:Interface]]</pre>
  
−
<nowiki>[[Category:Help]]</nowiki>
 
  
−
===Adding a Category to a Page with a Different Label===
+
===Adding a Link to a Category Page===
 +
[[:Category:Interface|Interface]]
  
−
<nowiki>[[Category:Help|Help category]]</nowiki>
+
<pre>[[:Category:Interface|Interface]]</pre>
  
−
===Adding a Link to a Category Page===
+
==Templates==
 +
Anytime you repeat the same information across multiple pages use a template. For example when a page is deprecated, we display the same message across the top on each page by adding that template. This is also done for commonly used terms.
 +
 
 +
<pre>{{ DeprecatedPage }}</pre>
 +
 
 +
To find or edit a templates type '''template:''' then your desired template name into the search.
 +
 
 +
When you edit a template at the bottom of the page you can see a list of pages that are using that template. Make sure you remove the template from those pages before you delete a template.
 +
 
 +
==Renaming a Wiki Article==
 +
Follow these steps in order to rename an article on the Wiki without losing your original content or hyperlinks from other pages:
 +
 
 +
1. Click on the '''More '''option on the top left of the Wiki page you wish to rename. 
 +
 
 +
2. Select '''Move. '''
 +
 
 +
3. Write your new article name in the left text box. 
 +
 
 +
4. Ensure that the '''Leave a redirect behind '''option is selected so that you will not lose continuity between hyperlinks. 
 +
 
 +
5. Click '''Move Page.'''
 +
 
 +
===Moving a Wiki Article to a New Category===
 +
You can also move Wiki articles to new categories (such as making them into a Category or Template page) by using the '''Move '''function. 
 +
 
 +
1. Click on the '''More '''option on the top left of the Wiki page you wish to rename. 
 +
 
 +
2. Select '''Move. '''
  
−
<nowiki>[[:Category:Help|Help category]]</nowiki>
+
3. Select the page's new category from the right drop-down field box. 
  
 +
4. Ensure that the '''Leave a redirect behind '''option is selected so that you will not lose continuity between hyperlinks. 
  
−
For more info, go to [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help: Categories]
+
5. Click '''Move Page.'''
  
−
==Templates==
+
==How to Add a User to the Wiki:==
 +
* On left panel, click on '''User Manager'''.
 +
* Click the green Add button.
 +
* Add '''smartstaff''' group.
 +
* Click '''OK'''.
  
−
Pages that start with the phrase "Template:" can be used in a similar fashion to SmartSimple's [[System Variables]]. They can contain blocks of text, such as commonly used terms, Wiki tables and uploaded images. You should use templates if a term, table or image will be repeated across multiple pages. The template can be referenced by surrounding the template name (minus the leading "Template:" string) with <nowiki>{{double brackets}}</nowiki>.  
+
==Deleting Articles==
 +
# Before you delete an article use the tool in the left navigation called '''what links here'''.
 +
# Once you have removed the links go to the '''More''' menu top right and select delete.
 +
# Make sure you delete all pages no longer required.
 +
# Delete the category the pages are grouped in if that is no longer needed.
 +
# Do a Search top right to make sure the content is not found on other pages.
  
−
===Example Templates===
+
==Finding Broken Links==
−
* <nowiki>{{UTA}}</nowiki> - returns {{UTA}}
+
When articles are deprecated or deleted, or the name is changed, it may result in broken links. You can see a list of broken links by going to https://wiki.smartsimple.com/index.php?title=Special:BrokenRedirects
−
* <nowiki>{{GUA}}</nowiki> - returns {{GUA}}
 
−
* <nowiki>{{LUA}}</nowiki> - returns {{LUA}}
 
−
* <nowiki>{{XML}}</nowiki> - returns {{XML}}
 
−
* <nowiki>{{ROSV}}</nowiki> - returns {{ROSV}}
 
−
* <nowiki>{{WPV}}</nowiki> - returns {{WPV}}
 
−
* <nowiki>{{l1}}</nowiki> - returns {{l1}}
 
−
* <nowiki>{{l2}}</nowiki> - returns {{l2}}
 
−
* <nowiki>{{CopyIcon}}</nowiki> - returns {{CopyIcon}}
 
  
−
==How to Add a User to Wiki:==
 
−
* On left panel, click on ''Special pages''
 
−
* Under '''Login / create account''', click on ''Create account''
 
−
* Fill in details and send random password
 
−
* On left panel, click on ''Special pages'' again
 
−
* Under '''Users and rights''', click on ''User rights management''
 
−
* Type in username, click on ''Edit user groups''
 
−
* Add ''administrator'', ''bureaucrat'' and ''smartstaff'' groups, click on ''Save user groups''
 
  
  
 
[[Category:SmartSimple]]
 
[[Category:SmartSimple]]
 +
 +
[[aitranscriptgpttest]]

Latest revision as of 15:23, 18 January 2024

Overview

SmartSimple’s Wiki is a repository of knowledge targeted at system Administrators intended to help make learning and configuring easier. This page will provide guidance for anyone who is contributing to the wiki. Following established standards will improve the user experience of this Wiki. All new articles should follow the template found in google drive > shared drives > Wiki project or look at the below. For statistics you can look at the dashboards and https://wiki.smartsimple.com/wiki/Special:SpecialPages

Wiki article structure

All wiki articles should follow this format:

Overview

Answer the following questions

  1. What is this article about? Example: The Login page allows a user to gain access to your SmartSimple System. The user will authenticate on this page, typically by entering a username and password.
  2. Why is this important? Example: The login page is used to: Authenticate the user, Switch languages, Direct people to a signup page, Ask the user to accept the use of cookies, enforce agreement of your systems privacy and security policies, and Reset your password.
  3. What will the reader learn from this article? Example: This article will show you how to setup and modify login pages within your system.
  4. Is there anything odd or important that should be noted? Example: Note: You will need global administrator access to setup or edit login pages. You will also need to create a separate login page for each language you want to support.

Configuration – Essentials

Break out all the tasks the majority of users will do and explain how to do them in the minimal steps possible. Use a numbered list for the tasks and keep them below 15 steps. If it is more than 15 steps to do something, break the task into multiple headers.

Configuration - Advanced

Break out all other tasks not listed in the essentials section. This section is meant for tasks that are particularly difficult, not commonly used or tricky/cumbersome.

Settings Explained

List all the settings used by this page/feature, what the setting does and if not self evident why you would use it. This should be presented in a table format. In time this may be replaced by an in system help.

Category

Make sure every article has a category. This way it is easy to find all related pages. Ideally all articles should be in one of the categories found on the home page https://wiki.smartsimple.com/wiki/Main_Page. This way anyone entering the wiki for the first time can find all the good articles. If an article falls into more than one category that is ok.

Other considerations

  • Use US English for spelling.
  • Use Microsoft conventions for writing instructions (When you refer to a button, check box, or other option, use bold formatting for the name)
Correct Select Save
Incorrect Select "save"

Note more help about the mediawiki can be found mediawiki.org

Text Formatting

Bullets

Create bullets like an unordered-list

  • Bullet 1
  • Bullet 2
* Bullet 1
* Bullet 2

Bold Text

Bold Text 

'''Bold Text'''

Italicized Text

Italicized Text 

''Italicized Text''

AddingSuperscript

textsuperscript 

Text<sup>superscript</sup>

AddingSubscript

Textsubscript 

Text<sub>subscript</sub>

#Numbered...

  1. Item
  2. Item
  3. Item
  4. Item
# Item
# Item
# Item
# Item

Preformatted text

You can have HTML or WIKI syntax appear the way you typed it by wrapping the code with an opening < and pre and > then a closing < / pre and > tag. This is used for code examples of what to type into the wiki. The pre stands for preformatted text. This will preserve the formatting of the text you entered (example tab, double spaces, new lines). Currently you cannot add code that has a closing tag < / > inside a pre as the slash will close the pre. We have tried other syntax such as nowiki and code but they all seem to exhibit the same issues after you save, edit then save again. The pre tag is not to be used for emphasis or notes. 

your code goes here
double space  double space
tab 	tab	tab

Heading Levels

Level 1 is for page name. 

==level 2==
===Level 3===
====Level 4====
=====Level 5=====
======Level 6======

Tables of Contents

MediaWiki adds a table of contents at the top of the page when you have four or more headers.
To change this behavior, at the top of the page, add: 

__NOTOC__ 	Hides the table of contents (TOC). 	
__FORCETOC__    Forces the table of contents to appear at its normal position (before the first header).
__TOC__ 	Places a table of contents at the word's current position (overriding __NOTOC__).

Hyperlinks

Links to Internal Pages

Link to internal page

Branding 

[[Branding]]

Link to internal page with different text

Different text 

[[Branding|Different text]]

Link to a heading on the same page

Heading Levels 

[[#Heading Levels|Heading Levels]]

Links to External Pages

Add a link to an external webpage

smartsimple.com 

[https://www.smartsimple.com smartsimple.com]


Note:

  • You must specify text for the link or it will show up as a number.
  • All external links open in a new window.

Email Links

sales@smartsimple.com 

[mailto:sales@smartsimple.com sales@smartsimple.com]

Image Files

  1. Under the Global Actions, press Upload file.
  2. Press the Choose File button to select an image and press Open.
  3. Press the Upload File button

Note: When adding screenshots, they should be approximately 1280 pixels wide and displayed at 800 pixels wide. When naming images, it is suggested to use the ticket number dash year dash number. That way it is easy to identify the related enhancement ticket and to see if the screenshot is out of date.


To display an image

four images of disabilities
The four disability classifications
[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|800px|The four disability classifications]]

Images are uploaded at a resolution of 1280 pixels but displayed at 800px. Make sure you add a caption.


Image with internal link

four images of disabilities
The four disability classifications
[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|link=Accessibility|800px|The four disability classifications]]

Image with external link

four images of disabilities
The four disability classifications
[[File:a11y-disability.png|thumb|none|alt=four images of disabilities|link=https://www.smartsimple.com/agreements.html|800px|The four disability classifications]]

You can upload a new version of any file by typing File: then your desired file name into the search.

Other Files

You can also upload files such as a zip file by entering the following and if it does not exist click on the link to upload the file:

File:Website-portal-sample-images.zip 

[[File:website-portal-sample-images.zip]]

Tables

Syntax

Syntax Description 
{|
 table start 
|+
 table caption, optional; only between table start and first table row 
|-
 table row, 
!|
 table header 
||
 table data each cell 
|}
 table end

Example

Sample Header Sample Header
Sample Text Sample Text
Sample Text Sample Text 
{| class="wikitable"
|-
!|Sample Header
!|Sample Header
|-
||Sample Text
||Sample Text
|-
||Sample Text
||Sample Text
|-
|}

Categories

You can categorize pages and files by adding one or more Category tags to the content text. These tags create links at the bottom of the page that take you to the list of all pages in that category, which makes it easy to browse related articles. 

[[Category:Interface]]


Adding a Link to a Category Page

Interface 

[[:Category:Interface|Interface]]

Templates

Anytime you repeat the same information across multiple pages use a template. For example when a page is deprecated, we display the same message across the top on each page by adding that template. This is also done for commonly used terms. 

{{ DeprecatedPage }}

To find or edit a templates type template: then your desired template name into the search.

When you edit a template at the bottom of the page you can see a list of pages that are using that template. Make sure you remove the template from those pages before you delete a template.

Renaming a Wiki Article

Follow these steps in order to rename an article on the Wiki without losing your original content or hyperlinks from other pages:

1. Click on the More option on the top left of the Wiki page you wish to rename. 

2. Select Move. 

3. Write your new article name in the left text box. 

4. Ensure that the Leave a redirect behind option is selected so that you will not lose continuity between hyperlinks. 

5. Click Move Page.

Moving a Wiki Article to a New Category

You can also move Wiki articles to new categories (such as making them into a Category or Template page) by using the Move function. 

1. Click on the More option on the top left of the Wiki page you wish to rename. 

2. Select Move. 

3. Select the page's new category from the right drop-down field box. 

4. Ensure that the Leave a redirect behind option is selected so that you will not lose continuity between hyperlinks. 

5. Click Move Page.

How to Add a User to the Wiki:

  • On left panel, click on User Manager.
  • Click the green Add button.
  • Add smartstaff group.
  • Click OK.

Deleting Articles

  1. Before you delete an article use the tool in the left navigation called what links here.
  2. Once you have removed the links go to the More menu top right and select delete.
  3. Make sure you delete all pages no longer required.
  4. Delete the category the pages are grouped in if that is no longer needed.
  5. Do a Search top right to make sure the content is not found on other pages.

Finding Broken Links

When articles are deprecated or deleted, or the name is changed, it may result in broken links. You can see a list of broken links by going to https://wiki.smartsimple.com/index.php?title=Special:BrokenRedirectsaitranscriptgpttest

Retrieved from ‘https://wiki.smartsimple.com/index.php?title=Wiki_Editing_CheatSheet&oldid=42169’