Editor Guide: Difference between revisions

From Information Revolt
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:
== THE MOST IMPORTANT GUIDELINE ==
== THE MOST IMPORTANT GUIDELINE ==
Internal links define and shape Information Revolt. The idea is for the site to resemble a tree with all of the branches connecting back to the homepage.  
Internal links define and shape Information Revolt. The idea is for the site to resemble a tree with all of the branches connecting back to the homepage.  
Pages should be placed in their appropriate location in the tree structure. Obviously, you wouldn't link to mid-17th-century Jewish pottery on the site's homepage. Putting it out of place on a top branch may be just as absurd. Communicate with other editors or ask the site administration if you are not sure where to place a new page. Going back after the fact and changing a page's location can be difficult and obnoxious. 
An editor is not necessarily required to add their pages to the tree structure, but people are unlikely to find them otherwise, and duplicate work may be created. Moreover, clashing page names are more likely to emerge if editors don't add their work to the tree. 
Page names can be changed after they are created, BUT BE VERY CAUTIOUS. If you change a page name and people have already created internal links to it, you will break all of those links. In general, it is best not to change page names. This means that you should think very carefully about what to name a page before you do so.
=== KEY PRINCIPLE ===
''The most difficult part'' of participating in the wiki is naming each wiki page something specific enough and keeping track so that there aren't duplicate pages on the same topic.
Everything else should be more or less self-explanatory and simple.
For example, early on, I named a page 'Ritual Murder' rather than 'Jewish Ritual Murder.' At the time, I was only thinking of one kind, but I should have been more cognizant. Later, I went back and changed the page name.
On the other hand, we don't want people to click through 30 irrelevant category layers to get to real info, so it's a balance.
As long as the site is diligently planned with a tree structure, it works well.
This site can be immensely cool and enormously useful. However, if people don't think carefully about the tree structure and page names, it could quickly become a quagmire. One reason editing rights are granted only to elite editors is this danger.


== How to Create Internal Links (Visual Editor) ==
== How to Create Internal Links (Visual Editor) ==
Line 73: Line 92:
** To remove a table of contents if you have more than four headings, type or paste in the source editor: <nowiki>__NOTOC__</nowiki>
** To remove a table of contents if you have more than four headings, type or paste in the source editor: <nowiki>__NOTOC__</nowiki>
*** It is good hygiene to place it at the top of the page so you and others can find it later.
*** It is good hygiene to place it at the top of the page so you and others can find it later.
== Locked Pages ==
For security reasons, certain key pages, such as the homepage, are locked. To have a page locked or unlocked, contact site administration.


== More Tips and Tools ==
== More Tips and Tools ==


* How to Change a Page Name
** STOP! Before you do so, read this.
** Click the 'More' tab above the toolbar and follow the instructions.
* Categories  
* Categories  
** The category function is one of the most useful tools.  
** The category function is one of the most useful tools.
** The categories tool is found on the toolbar at the top of the page, to the left of the switch editor and save changes buttons.  
** The categories tool is found on the toolbar at the top of the page, to the left of the switch editor and save changes buttons.
** Make Sure to use existing categories before creating new ones.  
** Make Sure to use existing categories before creating new ones.
* Table of Contents
* Table of Contents
** Be aware that if you have more than four headings, the site will automatically create a table of contents at the top of the page. If you have three headings or fewer and want a table of contents, you must manually create one in the source editor.  
** Be aware that if you have more than four headings, the site will automatically create a table of contents at the top of the page. If you have three headings or fewer and want a table of contents, you must manually create one in the source editor.  

Revision as of 19:54, 24 May 2026

Step One

Read the About page to make sure you understand the site's purpose.

Make sure you understand the Policies. Be aware of the site's broad subject matter and which topics are sanctioned.

If you have not been granted an editor account, you may apply for one.

THE MOST IMPORTANT GUIDELINE

Internal links define and shape Information Revolt. The idea is for the site to resemble a tree with all of the branches connecting back to the homepage.

Pages should be placed in their appropriate location in the tree structure. Obviously, you wouldn't link to mid-17th-century Jewish pottery on the site's homepage. Putting it out of place on a top branch may be just as absurd. Communicate with other editors or ask the site administration if you are not sure where to place a new page. Going back after the fact and changing a page's location can be difficult and obnoxious.

An editor is not necessarily required to add their pages to the tree structure, but people are unlikely to find them otherwise, and duplicate work may be created. Moreover, clashing page names are more likely to emerge if editors don't add their work to the tree.

Page names can be changed after they are created, BUT BE VERY CAUTIOUS. If you change a page name and people have already created internal links to it, you will break all of those links. In general, it is best not to change page names. This means that you should think very carefully about what to name a page before you do so.

KEY PRINCIPLE

The most difficult part of participating in the wiki is naming each wiki page something specific enough and keeping track so that there aren't duplicate pages on the same topic.

Everything else should be more or less self-explanatory and simple.

For example, early on, I named a page 'Ritual Murder' rather than 'Jewish Ritual Murder.' At the time, I was only thinking of one kind, but I should have been more cognizant. Later, I went back and changed the page name.

On the other hand, we don't want people to click through 30 irrelevant category layers to get to real info, so it's a balance.

As long as the site is diligently planned with a tree structure, it works well.

This site can be immensely cool and enormously useful. However, if people don't think carefully about the tree structure and page names, it could quickly become a quagmire. One reason editing rights are granted only to elite editors is this danger.

The most important mechanism is the internal links.

You can link to pages or even headings within pages. It is a remarkable tool!

If an Information Revolt page already exists, you can search for it and link it. If it has not been created, then you may create it.

  1. Highlight a word or phrase
  2. Click the Link button in the toolbar
  3. Search for the page name
    1. Pro Tip: You can copy any blue link on Information Revolt, including any heading, and paste it into the search bar.
  4. Select the correct page
  5. Click Done

Example:

  • Highlight “Ecclesiastes”
  • Link it to the Ecclesiastes page

How to Create a New Page

  1. Highlight a word or phrase
  2. Click the Link button in the toolbar
  3. Type the title of the new page
  4. Click Done

A blue link means: the page already exists

A red link means: the page does NOT exist yet

Red links are useful because they highlight missing topics and encourage the creation of future articles.

An external link is a link to any page that is NOT an Information Revolt page.

  1. Highlight a word or phrase
  2. Click the Link button in the toolbar
  3. Click the 'External site' tab
    1. It is to the right of the 'Information Revolt' tab
  4. Type or paste the full URL in the given bar
  5. Click Done

Visual Editor vs Source Editor

Editors are strongly advised to exclusively use the Visual Editor. The Source Editor is confusing and complex. Using it is almost like coding-- who would want to deal with that?

Source Editor Sample-- gross!

On the other hand, what you see in the Visual Editor is what you will see when you save changes and publish a page.

There are a few rare occasions when you may want to use the source editor.

  • Table of Contents
    • If you want a table of contents, but have fewer than four headings, it is impossible to create one in the visual editor.
      • If you have 4 or more headings, the site automatically generates one
    • To make one in the source editor, type or paste the following in the source editor: __TOC__
      • It is sensible to put it at the very top of the page
    • To remove a table of contents if you have more than four headings, type or paste in the source editor: __NOTOC__
      • It is good hygiene to place it at the top of the page so you and others can find it later.

Locked Pages

For security reasons, certain key pages, such as the homepage, are locked. To have a page locked or unlocked, contact site administration.

More Tips and Tools

  • How to Change a Page Name
    • STOP! Before you do so, read this.
    • Click the 'More' tab above the toolbar and follow the instructions.
  • Categories
    • The category function is one of the most useful tools.
    • The categories tool is found on the toolbar at the top of the page, to the left of the switch editor and save changes buttons.
    • Make Sure to use existing categories before creating new ones.
  • Table of Contents
    • Be aware that if you have more than four headings, the site will automatically create a table of contents at the top of the page. If you have three headings or fewer and want a table of contents, you must manually create one in the source editor.
  • Browser Extensions
    • Information Revolt is compatible with many browser extensions you may already have downloaded.
    • It may be useful to use an extension like Grammarly

FAQ

How the hell do I get images to work?

Fear not. It is actually quite simple. All of the steps are common sense except for step 9, which is where editors have been tripped up in the past.

  1. Click 'Insert'
  2. Click 'Images and Media'
  3. Select your recent image. Or, click the 'Upload' tab to the right of the 'Search' tab.
  4. Click 'Select a File'
  5. Select your File
  6. Click 'Open'
  7. Click the box to the right of 'This is my own work'
    1. This is an agreement that you are following fair use and copyright rules.
  8. Click 'Upload'
  9. KEY STEP: Add a description.
    1. You must add a description, or you will be unable to save.
    2. You should probably add a description anyway so you can cite the image's source.
  10. Click 'Save'
  11. Click 'Use this image'
  12. Adjust settings
    1. These may be changed later by hovering over the image and clicking 'Edit.'
  13. Click 'Insert'

Talk Pages

These may be used for editors to coordinate page revisions. They are not to be used as chat rooms or for personal DMs.

It is recommended that Talk pages be used minimally.

Help

If in doubt, ask for help. Bugs or problems can be reported to informationrevolt@protonmail.com.

You may likewise message the official Substack account.