Help:Beginner's guide to Index: files

From Wikisource

Help:Beginner's guide to Index: files

[edit] Beginner's how-to for DjVu uploading

The most common use of the side by side view is for proofreading complete books or texts in DjVu format. To begin a new DjVu proofreading project, you would do the following:

1. Get or create a DjVu file of the book or other text you want to work on. If you have a PDF, there are various methods for converting PDF to DjVu at Help:DjVu files. If you can include OCR text in the file, this is preferable because it will automatically populate and save an immense amount of time when you and others proofread the text.
2. Upload the DjVu file to wikimedia commons using the Basic Upload page or the Advanced Upload page. The Advanced Upload page provides less coaching about copyright status, so if you are doing a large number of public domain works it will probably save you time. Choose a useful filename in the Destination filename box... the best option is the full title as you want it to appear in Wikisource. If the full title is very long, a shortened title may be appropriate.
3. In your browser (perhaps in a new tab or window), type http://en.wikisource.org/wiki/Index:the name of the file you just uploaded.djvu. For example, if the file uploaded to commons was Wind in the Willows (1913).djvu then you would want to type in http://en.wikisource.org/wiki/Index:Wind in the Willows (1913).djvu Using copy/paste for the name of the file is the best choice— it is very easy to type something wrong, mix up upper and lower case letters, etc. Using copy/paste avoids these pitfalls.
4. A window that says no such file exists will appear. Click create and you will see a window like this sample of Wind in the Willows, with no data populated into it.
5. Populate each of the tags as follows:

• Author: [[Author:Author's name|Author's name]]
• Title: The title as you want it to appear, or the full long title. Use double brackets around the title that you want to be used as the Wikisource page name. Example: [[The Raven]]. If you discover that, like The Raven your title belongs to more than one work, there will need to be a disambiguation page (like the one at The Raven and your work will need a disambiguation name like [[The Raven (Poe)]]. Making this only display The Raven looks like this: [[The Raven (Poe)|The Raven]]
• Year of Publication: The year the djvu was published; you might include the original year of publication here if the republication is not a new edition (an unchanged reprint of the same book).
• Publisher: Type in the name of the publisher.
• Key: defaultsort key, to use to modify the index's sorting
• Source: the type of image file: djvu, pdf, jpg, gif
• Cover image: for displaying an identifying page of the file. If the front cover is appropriate, simply add 1, otherwise specify your preferred page number
• Pages: If you want to format your pagelist, you can follow the instructions at the ProofreadPage documentation.
• Remarks: Remarks is generally used for the book index. Other comments could be placed here as well. The information placed here will appear in a third column at the right of the page. If this space is blank, there will be two columns on the page.

1. 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. If the image does not appear, make certain that you have the name exactly the same as you had it at Wikimedia Commons. Once you see the page and make any corrections which become apparent in the preview, click "Save page".
2. Now you can begin filling in the individual pages with the text as they appear in the book. Review the suggestions below before starting—they cover important formatting topics that would be time-consuming to insert into the text later. After the text of the book is typed in, you can use "transclusion", which is described below, to form the individual pages into chapters or other logical sections as you think most appropriate.