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.

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.

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 2017. The Paper Conservation Catalog and the Book Conservation Wiki are publications of the Book and Paper Group of the American Institute for Conservation of Historic and Artistic Works. 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 Boxes

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

·Examination ·Documentation

Structural Elements of the Book

·Endpapers ·Leaf Attachment/Sewing Repair ·Endbands ·Boards ·Decoration

Book Materials

·Animal Skin/Leather ·Parchment ·Cloth

Conservation Treatment

·Washing ·Alkalinization ·Leaf Attachment/Sewing Repair ·Board Reattachment ·Preservation and Conservation of Scrapbooks

Preservation

·Selection for Preservation ·Exhibition, Supports, Transport ·Imaging and Digitization ·Housings ·Encapsulation






Book and Paper Group
Paper Conservation Catalog
Examination and Documentation

·Fiber Identification ·Written Documentation ·Visual Examination ·Spot Tests

Problems and Issues

·Media Problems ·Support Problems ·Foxing ·Mold ·Parchment

Conservation Treatment

·Surface Cleaning ·Hinge, Tape and Adhesive Removal ·Washing ·Sizing & Resizing ·Bleaching ·Alkalization and Neutralization ·Humidification ·Consolidation/Fixing/Facing ·Backing Removal ·Mending ·Filling of Losses ·Drying and Flattening ·Lining ·Inpainting ·Adhesives ·Matting and Framing ·Annual Meeting Tips Sessions (various topics)

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.