Editing Tutorials

From UCSB Nanofab Wiki
Revision as of 23:55, 4 September 2018 by John d (talk | contribs) (→‎Making a New Page: added screenshot showing to click "Create" tab)
Jump to navigation Jump to search

Basic Editing

Editing an Existing Page

The First step is to log in:

Wiki- Log In - Screen Shot 2017-11-30 at 4.14.49 PM.png

Then navigate to the page you want to edit.

Once you are at the page, click on "Edit" to launch the Visual Editor. "Edit Source", allows you to edit the wikimarkup source code directly, which is much less intuitive and not recommended.

Click Edit.

After clicking [Edit], you will be able to type directly into the page to make your changes.

There are a couple of key things to note on this page.

Press the [< Back] button on your web browser to cancel/discard any changes you made.
Save page: Clicking this will save any and all changes you have made.
Show preview: This will show you a preview of what the page will look like after you save it.
Show changes: This will give you a before and after comparison of the page.
Cancel: This will cancel any changes.
Rich Editor: For [Edit Source] mode, this will open the rich text editor (which is explained below).

  • The Visual Editor opened by hitting [Edit] is pretty self-explanatory for most purposes. See the Visual Editor User Guide for more info on using the editor. The "Editing Tables" section is useful for our etch/deposition tables.
  • Please use Show Preview to make sure your edits look as expected.
  • Be sure to enter a brief description of what you changed, so Editors can approve you changes quickly.

Using the Visual Editor on a text page:

Visual Editor in action, animated

The [Edit Source] mode, showing wikimarkup source code for the page. [Rich Editor] provides some code shortcuts:

Basic2.png

We do have some old antiquated "coded" parts of the site, which are holdovers from before we installed the modern "Visual Editor". Due to existing page linking/URLs, many of these can't be changed (such as code used for superscripts and subscripts in page names).

Making a New Page

The preferred way to make a new page is to first create a Link to a page that doesn't exist, within an existing page. Do this as follows:

  1. On the existing page, [Edit] the page, and type the text you would like to become a hyperlink.
  2. Select the desired text, and click the Hyperlink button Editing Toolbar Hyperlink Button 01.png which pops up the link panel.
  3. Type the desired name of the new page into the "search" field - it will show a red link in the search field, indicating that the page doesn't exist yet.
    Screenshot of hyperlink panel, Creating a hyperlink to a nonexisting page.
    Creating a hyperlink to a nonexisting page.
  4. After Saving the existing page, you will see a "Red Link" - colored red because it leads to a nonexistent page.
    A "red link", linking to a nonexistent page.
  5. Click the red-link to the nonexistent page, which will show an option to create the new page.
  6. Click [Create] to make the new page in VisualEditor mode (defaults to Source mode, which is not recommended).
    Screenshot showing to Click on "Create" Tab to enter VisualEditing Mode
    Click on the "Create" Tab to enter VisualEditing Mode
  7. Make sure to "Save" the new page!

Administration

Approving Edits (Staff/Admin only)

While lab users are allowed to modify the wiki, their edits will not become visible to anyone until a staff member approves those edits. (When any member of the staff edits a page, those edits are automatically approved.)

NOTE TO STAFF: Take care to watch for approvals before editing because if a page has edits waiting to be approved and you edit the page normally, those edits will automatically be approved!! Before you edit a page, always make sure that there are no new revisions waiting to be approved (this is described below).

When you arrive at a page, you will see one of two messages. Either "No new revisions" or "THERE ARE NEW REVISIONS TO THIS PAGE.".

No new revisions.
THERE ARE NEW REVISIONS TO THIS PAGE.

If there are new revisions, click on the history tab.

History tab.

This will take you to the full edit history of the page. You will see an entry that has a star on it, this is the current approved revision. Anything after that (above it) has not yet been approved. Put the LEFT radial button on the currently approved revision and set the right radial button anywhere above it to compare other additions. Click "Compare selected revisions".

History

The window will show you the before (on the left) and the after (on the right). You can also scroll down to see how the NEW page actually looks (AFTER the edit you are view has taken effect). In this case, the user "Guest" has deleted the sentence "The Sharon is a cryo-pumped thin film evaporator with a Temescal four hearth 270° bent beam evaporation source." and has inserted the sentence "THIS IS A TEST". If you like the edit and want to keep it, go back (by pressing the back button in your web-browser) and then click approve next to the edit in question. If you do NOT like the edit, click "undo", then scroll to the bottom of the page that opens and click save. If you like part of the edit but want to modify it, approve it, then edit the page as you normally would.

Approve5.png

My Watchlist

Your watchlist is the set of pages that you are "watching" for changes. You can view you watchlist at any time by clicking the link in the top right of the screen.

Watch1.png

I strongly recommend that you each add your tools to your watch list. This will allow you to see whenever these pages are modified by a user. To add a page to your watch list, go to the page you want to add and click on "watch" at the top of the page. (To remove a page from you watchlist, do the same thing, the button will read "unwatch" instead.)

Watch2.png

You can also set it up so that you will recieve an e-mail any time one of the pages on your watchlist is changed (by someone other then yourself). I would also HIGHLY recommend doing this. These emails will come from NanofabWiki@ece.ucsb.edu so you can setup a filter and put all these e-mails in one folder. You will only receive one e-mail per page between visits. In other words if 10 people make changes back to back. You will only get ONE e-mail notifying you that a change has been made, not 10 e-mails. As soon as you view the page form your account, that resets so any changes made after you view it will result in another, single e-mail.

To set this up go to your preferences by click on the "my preferences".

Watch3.png

In your preferences you will find a lot of options. The 2 that you need to take care of are your e-mail address (enter it into the box labeled "E-mail") and you need to check the box next to "E-mail me when a page on my watch-list is changed." Save the changed by clicking "Save" at the bottom of the page.

Editing Restrictions

To prevent unauthorized editing on the site, we have setup 4 different user groups. These restrictions only pertain to EDITING.

1) Annonymous/Unregistered users

Anyone not registered or not logged in will not be able to edit anything on the site.

2) Lab Users

This is anyone who we know to be doing research in the lab (names taken from SignupMonkey). They are allowed to edit existing pages but are not allowed to upload files or create new pages. All edits by Lab Users have to be approved by staff members before they are viewable on the site.

3) Staff

This group consist of all staff members. Staff will be able to edit 95% of the pages on the wiki. There are a select few pages on the site that are locked. For example, on the Main Page, Staff do not have the option to "EDIT" the page, only the option to "VIEW SOURCE"

4) Administrators

This group is for the people in charge of maintaining the nitty-gritty of the site. They have unrestricted access and can change anything on the site. They can also change the "user group level" for any user.