Smartstaff, administrator
3,321
edits
Changes
→Links to External Pages
=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 intended contributing to assist editors 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 # What is this article about? Example: The Login page allows a user to gain access to your SmartSimple Wiki make revisions 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=====Bullets===Create bullets like an unordered-list * Bullet 1* Bullet 2 <pre>* Bullet 1* Bullet 2</pre> ==='''Bold Text'''==='''Bold Text''' <pre>'''Bold Text'''</pre> ===''Italicized Text''===''Italicized Text'' <pre>''Italicized Text''</pre> ===Adding<sup>Superscript</sup>===text<sup>superscript</sup> <pre>Text<sup>superscript</sup></pre> ===Adding<sub>Subscript</sub>===Text<sub>subscript</sub> <pre>Text<sub>subscript</sub></pre> ===#Numbered...===# Item# Item# Item# Item <pre># Item# Item# Item# Item</pre> ===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 additionscode 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. <pre>your code goes heredouble space double spacetab tab tab</pre>
==Heading Levels==
==Hyperlinks==
===Links to Internal Pages===
Link to internal page
[[Branding]]
<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
===Links to External Pages===
==Image Files==
# Under the '''toolboxGlobal Actions''', click press '''Upload file'''.# Upload Press the '''Choose File''' button to select an imageand press '''Open'''.# On Press the page you wish to display the image: enter this format: '''Upload File''' button
<pre>[[File:website-portal-sample-images...produces this...zip]]</pre>
==Tables=====Syntax==={| borderclass="1wikitable"|'''Menu or Application'''|'''Search For'''
|-
!|Organization, Search PeopleSyntax!|People: internal and external, related companies, standard and custom fields.Description
|-
|Communications, Contacts|<pre>{|</pre>|External people only - limited search capabilities.|'''table start'''
|-
|[[Universal Tracking Application]] |<pre>|+</pre> Contact Tab|Same page as the |table '''caption,''' optional; only between '''table start''' and first '''table row'Search People'' page.
|-
|[[Universal Tracking Application]] |<pre>|-</pre> Company Tab|Same functionality as the |''Search People'table row,''' page, but with companies.
|-
|Sales Tracking Application |<pre>!|</pre> Company Tab|Same page as the Company tab in the [[UTA]]|'''table header'''
|-
|Sales Tracking Application |<pre>||</pre> Contacts Tab|Same page as the |'''table data'Search People'' pageeach cell
|-
|Sales Tracking Application |<pre>|}</pre> My Contacts|Limited to contacts associated with companies where the current user is the owner.|'''table end'''
|}
<pre>{| class==Tables of Contents=="wikitable"|-!|Sample Header!|Sample Header|-||Sample Text||Sample Text|-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>|Sample TextTo change this behavior, at the top of the page, add:||Sample Text <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__</nowikipre>).
==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.
<pre>[[Category:Interface]]</pre>
===Adding a Link to a Category Page===
[[:Category:Interface|Interface]]
<pre>[[:Category:Interface|Interface]]</pre>
==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.
[[Category:SmartSimple]]
