Wiktenauer:Tutorial/Indexing

Introduction

Uploading

Indexing

Transcribing

Proofreading

Validating

Translating

Publishing

Final Advice

For a complete list of current Index pages, see Category:Index

An example Index page after it has been created with completed fields.

Indexing source files

Once the file has been uploaded to the correct place, an Index page needs to be created on Wiktenauer. Index: pages, managed by the Proofread Page extension, are a powerful way to allow side-by-side proofreading of transcriptions in Wiktenauer. This document describes the fastest way to set them up on Wiktenauer.

Index pages are the main page for each transcription project on Wiktenauer. Each one will have links to all the individual pages in the book, manuscript, or other text being transcribed. The page will also show the progress of the transcription and a quick summary of the text's details (such as title, author(s), etc.). These details can link to other pages such as the treatise and master pages in the mainspace.

Creating an Index: page on Wiktenauer

Index pages need to have the same name as the file you just uploaded. For example, the file Book.pdf will appear on either Commons or Wiktenauer as File:Book.pdf and the index page must be called Index:Book.pdf.

1. Determine the name of the Index page:
• For PDFs, replace the "File" with "Index" in the URL and go to this page. For example, if the file is called File:Title (Author).pdf, enter the page title Index:Title (Author).pdf.
• For image galleries, just affix "Index:" to the beginning of the treatise page name. For example, if the page is called Manuscript name (Shelf mark), enter the page title Index:Manuscript name (Shelf mark).
2. Wiktenauer will indicate that "Wiktenauer does not have a page with this exact name". Click the "Create" link at the top (or the "add Index:file name to Wiktenauer") to create this document.
3. Fill in any information you know (refer to the table below), leaving any unknown or inapplicable information blank.
Index: page fields 

Field name	Description	Example
Author	The name of the author. This can be wikilinked to a "Master" page on Wiktenauer, such as Johannes Liechtenauer.	[[Johannes Liechtenauer]]
Title	The title of this work. It's a good idea to create a "Treatise page for this work on Wiktenauer (such as Goliath Fechtbuch (MS Germ.Quart.2020)), and then link to that in this field.	[[Goliath Fechtbuch (MS Germ.Quart.2020)]]
Editor	The editor of this work. For manuscripts, place the name of the scribes in this field.	[[Michel Rotwyler]]
Year of Publication	The original year of creation or publication of this edition of this work. Try to be as precise as possible.	1510-1520
Publisher	The publisher of this work. This can be wikilinked if a portal exists for the publisher. If not, the name of the publisher is enough. For manuscripts, the name of the patron who commissioned the work goes here.	Eberhardt von Württemberg
Source	The type of image file: djvu, pdf, jpg, jpeg, gif, and so on.	png
Cover image	The page of the document which has the cover image. In most cases, this will be page 1; however, in some scanned material, the actual cover might be on a later page. If you're using individual images, you can use [[file:File:MS Germ.Quart.2020 IIr.jpg|200px]] to set a cover image.	3 or [[file:File:MS Germ.Quart.2020 IIr.jpg|200px]]
Progress	The status of the page, which sorts it into one of seven categories: X – No scans available C – Ready for proofreading L – Scans need to be formatted before uploading V – Ready for validation OCR – Ready for transcription T – Ready for translation MS – Ready for match and split	MS
Pages	The <pagelist /> command is an easy way to let people know how the pages in a PDF are structured. You can just use <pagelist /> to use the order of pages in the uploaded file. However, you can also use it to indicate pages which shouldn't be numbered; for instance, <pagelist 1to2=- 3=1 /> will cause pages 1 and 2 to be represented as unnumbered pages ('-'), and page numbering will start by setting the third page of this document as page 1. Play around with this feature, and use Preview to check what the pages list looks like. You can also create a page list manually by replacing "File" in the name of each individual image with "Page" and then creating a link (using the page or folio number as its name).	<pagelist 1to16=- 17=1 25to26=- 27=9 69to70=- 71=51 386to390=- /> or [[Page:MS Germ.Quart.2020 001r.jpg|1r]] [[Page:MS Germ.Quart.2020 001v.jpg|1v]] [[Page:MS Germ.Quart.2020 002r.jpg|2r]] ...
Table of Contents	A table of contents for the text. Usually this will link to the chapters as they are in the main namespace. This can be copied directly from the treatise page if any exists. However, if the text includes its own table of contents, this can be shown instead by transcluding the pages from the text (use the name of each page, wrapped in two curly brackets—or braces—at either side).	{| class="wikitable" |- ! Folio ! Section |- ! [[Goliath Fechtbuch (MS Germ.Quart.2020)|Ir - IIv]] | Front matter |}

4. Click the "Show Preview" button near the bottom of the page. An Index: namespace page with an image of the book you just selected should appear (for PDFs). If the image does not appear, make certain that the name of the page is identical to the name of the file you uploaded. Once you see the page and make any corrections which become apparent in the preview, click "Save page".

Notes: The fields on the Index page should also be completed but this can be done at any time. The index page will automatically generate a page list and display the first page of the file (usually the cover). Both of these can be changed as described below.

Any known problems or defects with the source file should be noted as they are discovered either in the remarks (table of contents) section of the Index: page or on the Index's talk page.

Citing sources

Once your index page is created, open the Discussion and License Info tab and use the {{Sourcebox}} template to document the source of the scans. A line should be created both for the source of the scans and for any existing transcription that has been authorized for Match and Split (see the transcription tutorial). Here is an example from Index talk:Goliath Fechtbuch (MS Germ.Quart.2020):

Work	Author(s)	Source	License
Images	Biblioteka Jagiellońska	Biblioteka Jagiellońska
Transcription	Monika Maziarz, Bartłomiej Walczak, Grzegorz Żabiński	Stowarzyszenie na Rzecz Dawnych Europejskich Sztuk Walki

What about works without scans?

Ideally all works on Wiktenauer will eventually include scans, replacing the works already present that do not. However, it is still okay to add proofread texts from other sources. Create the index page as normal, and paste the transcription into the Pages field. It can then be matched and split whenever scans become available. Make sure you add the {{second-hand}} template to the Index's discussion page for tracking purposes.

Continue the tutorial with transcribing →