Wiki Editors' Resources

From Wiki

Welcome to the Resources for AIC Wiki Editors page. This page contains links to helpful guides, how-to videos, and other resources for working with MediaWiki.

General Information

Online Guides

How-to Videos

Other Resources

Macros or Plug-Ins can be a useful time saver in converting word processing document formatting to wiki text. The two listed here work with Microsoft Word and convert basica formatting into wiki markup.

Book and Paper Specialty Group Resources

There are some AIC and BPG guidelines for creating and maintaining pages, as well as some BPG guidelines about what processes we found to work best in online collaboration. These are available at AIC-Wiki Resources, BPG Wiki Resources, and at AIC's User Guidelines. Taken together, they will make for a good-looking, consistent and useful wiki. If you find yourself unsure of style questions, formatting, or with the collaborating process, please don't hesitate to ask the AIC-Wiki listserv and the BPG Wiki Coordinators.

Technical Guidelines

AIC-Wiki Resources include very general videos about adding and editing basic content, a helpful link to MediaWiki forums, and BPG Wiki Resources. The BPG Wiki Resources portion contains information on AIC's style guide, how to name new pages and pictures, categories, portals, and templates for disclaimers. repeats some information and is not focused on BPG topics, but it is also a good place to discuss Wiki structures.

Style Guide

The BPG wiki follows the general AIC Wiki Style Guide, in terms of text formatting, link creation, and reference citing. This is especially important when creating links and lists of references - please use the JAIC style, and refer to this part of the Style Guide for additional information. In addition, there are a few BPG specific style rules that should be followed.

New page titles

When creating new pages, please first check to make sure there isn't already a page that fits your need. If there isn't, name your page in a simple but informative fashion; please do not put "BPG", "Book and Paper", or "Chapter 1" type of language in the title itself. This information can be placed into the body of the page, with headers and the use of categories.

Pages can be renamed by using the "Move" function, and redirects created for any links going to the old page name.

Table of Contents Formatting Options

The table of contents (TOC) can be adjusted to better fit a page's needs. If no special coding is added, the TOC will be at the top of the page and span the width of that page. You can add a line of code to the page to customize the table of contents to "float" to one side.

This code can be adapted for a page's needs as follows:
For a TOC floating to the right side: <div style="float:right; clear:both; margin-left:0.5em;">__TOC__</div>
For a TOC floating on the left side (not recommended as it misaligns headers): <div style="float:left; clear:both; margin-right:0.5em;">__TOC__</div>
For a larger spacing between content and TOC: <div style="float:right; clear:both; margin-left:1.0em;">__TOC__</div>


Note -- Wherever this code is placed in the "Wikitext" is where it will appear on the page. For example, if you remembered you wanted to adjust the TOC when you reached the bottom of the Wikitext page and placed the TOC code at the bottom of the page, the TOC would appear at the bottom of the page, not the top of the page. This can be incredibly useful if you want images to precede the TOC on the page, but please be sure the TOC is easily accessible somewhere near the top of the page, as that is where most people anticipate finding a TOC.

Naming and formatting pictures

Photos (.jpg, .gif, .pdf, and others) can be uploaded by clicking on the "Upload file" link at the bottom of the left-hand navigation of each page. It's best if the image is edited, cropped, and compressed to a manageable byte-size (let's try under ~ 5MB per image) before uploading. The dimensions of the image can be adjusted before uploading too, but it is not entirely necessary because most times it will still be necessary to tweak the size to make it look ok in the page.

To insert a photo as-is is not recommended because there are no limits for the dimensions and no abilities to add captions. But to do so, use double brackets (as if you are making an internal link) like this: [[File:Woodboard60.3.jpg]] It will look like this:
Woodboard60.3.jpg

For the aforementioned reasons, it's highly recommended to adjust the image to thumbnail size. You can do this with the following code, which will size the image for you, let you align it on the right or left, and allow you to insert a caption. (And clicking on the thumbnail will bring the user to the full image.) [[File:Woodboard60.3.jpg|thumb|right|Wood board, supports laced-in but not trimmed]]
Wood board, supports laced-in but not trimmed


Keep in mind that there are quite a lot of variations of code that can be successfully used to insert images. For example to adjust the displayed size of an image, add a pipe ( | ) after the file name and specify the pixel width you desire (the aspect ratio will remain constant, i.e., the height will remain in proportion), such as [[File:Woodboard60.3.jpg|125px]] Woodboard60.3.jpg

A final note, apropos to the display of sample images here. References to images usually require some tweaking of their code to look good. It is recommended to use an existing code first, like the "thumb" provided above, and then add complexity when you have a strong familiarity with the MediaWiki software.

Bulleted and Numbered Points and Sub-Points

A list of bulleted and numbered points can be added as needed into wiki page.

Bulleted Lists:
Bulleted points can be added by preceding each line of a list with an asterisk " * ." For each sub-level within a list, you would add another asterisk.

Wikitext Appears as
*This is a bulleted list
*More list items
**sub-item in list
***sub-sub-item in list
  • This is a bulleted list
  • More list items
    • sub-item in list
      • sub-sub-item in list


Numbered Lists:
Numbered points can be added in much the same way as bulleted points. Each line would be preceded by the pound sign " # ". For each sub-level within a list, you would add another pound sign.

Wikitext Appears as
#one
#two
##2.1
###2.1.1
  1. one
  2. two
    1. two.1
      1. two.1.1


Bibliography and Citation Format

For general format please see: AIC wiki Style Guide AIC Wiki Style Guide When creating citation links between the text and the bibliography please use the following format:
Single Author: refLastNameYEAR
Example of in-text citation (Williams et al. 1977, 49; 57-58)
Example of Bibliographic entry:

Williams, J. C., C. S. Fowler, M. S. Lyon and T. L. Merrill. "Metallic Catalysts in the Oxidative Degradation of Paper." Preservation of Paper and Textiles of Historic and Artistic Value, John C. Williams, editor (Advances in Chemistry Series No. 164). Washington, D. C.: American Chemical Society, 1977, 37-61.

Two Authors: refLastNameLastNameYear
More than two Authors: refLastNameetalYear

Using Categories

  • Categories help users find related pages, by creating a sort of "index" to the wiki that, when used correctly, can be more effective for finding information than using the search function of the site. Pages can be tagged with an unlimited number of categories. Please note that category names are case sensitive, but you can easily add categories to pages by using the Link-creator button (which looks like a chain) in the editing panel. Just search for "Category:" and the first letter of the category you want to add, and you should be able to pick it from the list of available categories.
  • Please tag all Book and Paper Group wiki pages with the following category: [[Category:Book & Paper]]. The category should be placed at the top of the page.
  • Whenever possible, please also tag pages with additional categories. The following categories could be useful for Book and Paper Group related pages:
    • [[Category:Damage]]
    • [[Category:Documentation]]
    • [[Category:Drying]]
    • [[Category:Emergency Response and Recovery]]
    • [[Category:Filling of Losses‏‎]]
    • [[Category:Flattening]]
    • [[Category:Housing]]
    • [[Category:Humidification]]
    • [[Category:Mending]]
    • [[Category:Mold/Fungi]]
    • [[Category:Preventive]]
    • [[Category:Paper]]
    • [[Category:Surface Cleaning]]
    • [[Category:Tape Removal]]
    • [[Category:Testing]]
    • [[Category:Water Damage]]

Disclaimers

To insert a header that contains a copyright notice and lets readers know that the page is part of the Book and Paper Group wiki, you can use the Copyright disclaimer header by inserting {{BCC-PCC-copyright}} at the top of the page. The header looks like this:

Book-Paper.gif

Copyright 2019. The Paper Conservation Catalog and the Book Conservation Wiki are publications of the Book and Paper Group of the American Institute for Conservation. They are published as a convenience for the members of the Book and Paper Group. Publication does not endorse nor recommend any treatments, methods, or techniques described herein.

Progress/Status Banners

  • For works still in progress, use the In Progress template by writing {{In Progress}} at the top of the page, which looks like this:
This entry is in the process of being corrected
  • For works in their "first draft" state, use the Draft template by writing {{IN PROGRESS DRAFT}} at the top of the page, which looks like this:
THIS ENTRY IS A DRAFT

Navigation and Portals

  • To provide a list of links to other parts of the Book and Paper Group Wiki, use the Navigation box for BPG Wiki pages template by inserting {{BPGPortal}} at the bottom of the page. The portal looks like this:
Book and Paper Group Wiki
Using the Wiki

·Contributors Toolbox ·Reference and Bibliography Protocols ·Accessing Conservation Literature (AIC) ·Help Wanted ·Template for New BPG Chapter

Materials and Tips

·Annual Meeting Tips Sessions ·Materials, Equipment, and Tools ·Adhesive Recipes and Tips
·Gels, Thickeners, and Viscosity Modifiers (ECPN) ·Oddy Tests (R&A) ·Instrumental Analysis (Paintings) ·Technical Examination (Paintings) ·Microchemical Testing (R&A)

Preservation

·Selection for Preservation ·Exhibition, Supports, Transport ·Imaging and Digitization ·Housings ·Encapsulation ·Integrated Pest Management (AIC) ·Environmental Guidelines (AIC) ·Environmental Monitoring (AIC) ·Agents of Deterioration (AIC) ·Light Levels (AIC) ·Pollutants and Contaminants (AIC) ·Emergency Preparedness & Response (AIC)

Conservation History and Ethics

·AIC Code of Ethics and Guidelines for Practice ·Culturally Sensitive Treatment ·Conservation Ethics (AIC) ·History of Conservation and Conservators (AIC)

Process Guidelines for Group Work

Each group that commits to Revising a Chapter is given a lot of freedom to work how they best see fit. Thus far in BPG's involvement, there have been some methods and practices that have made the workflow truly collaborative and successful.

Regular Communication

Via email and conference calls have been extremely helpful to keep collaborators on the same page. The AIC-Wiki listserv is sometimes useful to ask technical questions, but most times WikiMedia help pages are best.

Multiple Editing Passes

To make new pages multiple editing passes by the lead compilers in short succession have been extremely helpful. All suggestions and potential additions are added to the Discussion Tabs by other contributors, but the lead compilers are able to "make the call" about what should be kept or left out.