instructions
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
instructions [2012/05/17 14:44] – [Example] sbw | instructions [2014/12/08 22:38] – [I made a mistake...] sbw | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Instructions ====== | ||
+ | ===== Introduction ===== | ||
+ | All of the magazines on the site have been run through an optical character recognition (OCR) tool, which converts the images in the PDF files to text. Unfortunately, | ||
+ | |||
+ | {{ocr_html.png? | ||
+ | |||
+ | **Don' | ||
+ | |||
+ | If you click the **Edit this page** button, you'll see some text that looks something like this: | ||
+ | |||
+ | {{ocr_text.png? | ||
+ | |||
+ | A bit more readable, but still in need of some work. Time to get going! | ||
+ | |||
===== Text corrections ===== | ===== Text corrections ===== | ||
- | Generally speaking, the aim is to get the text content exactly the same as in the PDF. [[# | + | Generally speaking, the aim is to get the text content exactly the same as in the PDF. [[# |
+ | |||
+ | < | ||
+ | |||
+ | This is the next paragraph</ | ||
While in general the content should be the same as the PDF, the following changes should be made: | While in general the content should be the same as the PDF, the following changes should be made: | ||
* Page headers and footers should be removed eg < | * Page headers and footers should be removed eg < | ||
* Advertisements should be removed altogether | * Advertisements should be removed altogether | ||
- | * Images should be removed altogether (along with any text directly relating to that image) | + | * Images should be removed altogether (along with any text directly relating to that image). However, if that image is particularly important, such as a map relating to a walk, you can leave a note on the [[magazines|tracking page]] that it should be included. |
* People’s names should be corrected, if you know they are incorrect eg **Ian Wolf** should be **Ian Wolfe** | * People’s names should be corrected, if you know they are incorrect eg **Ian Wolf** should be **Ian Wolfe** | ||
* Place names should be corrected, if you know they are incorrect eg **Wollangambe**, | * Place names should be corrected, if you know they are incorrect eg **Wollangambe**, | ||
Line 12: | Line 30: | ||
* Fix general spelling errors where noted | * Fix general spelling errors where noted | ||
* Punctuation and grammar may be corrected, but this is often a matter of taste, so only correct where it is clearly wrong | * Punctuation and grammar may be corrected, but this is often a matter of taste, so only correct where it is clearly wrong | ||
- | * Separators such as %%********%% or %%=========%% should be removed | + | * Separators such as %%********%% or %%========%% should be removed |
===== Text formatting ===== | ===== Text formatting ===== | ||
Line 18: | Line 36: | ||
The number one priority is to get the text corrected. However, it will certainly help us if you can spend a bit of extra time to get it into a more readable format. | The number one priority is to get the text corrected. However, it will certainly help us if you can spend a bit of extra time to get it into a more readable format. | ||
- | As mentioned above, the most important thing is the paragraph - leave a blank line to automatically create one. | + | As mentioned above, the most important thing is the **paragraph** - leave a blank line to automatically create one. |
If you would also like to format the resulting text, please use the following conventions where possible. Note that recent newsletters may have a fair bit of formatting, so some of these conventions may be difficult to follow: | If you would also like to format the resulting text, please use the following conventions where possible. Note that recent newsletters may have a fair bit of formatting, so some of these conventions may be difficult to follow: | ||
* Use [[wiki: | * Use [[wiki: | ||
- | * Use Heading 2 (%%===== Heading 2 =====%%) for story titles, and Heading 3 (%%==== Heading 3 ====%%) for subtitles. | + | * Use Heading 2 (%%===== Heading 2 =====%%) for story titles, and Heading 3 (%%==== Heading 3 ====%%) for subtitles. |
- | * Use a [[wiki: | + | * Use a [[wiki: |
+ | Avoid using the forced line break (\\) except where absolutely needed eg poems. Use a normal paragraph break in most cases. | ||
===== Example ===== | ===== Example ===== | ||
For an example of a largely complete magazine, see [[199201|January 1992]]. If you click on **Edit this page** (you need to be logged in), you can also see examples of all of the formatting. | For an example of a largely complete magazine, see [[199201|January 1992]]. If you click on **Edit this page** (you need to be logged in), you can also see examples of all of the formatting. | ||
+ | |||
+ | ===== I made a mistake... ===== | ||
+ | |||
+ | If you make a mistake while editing, and you haven' | ||
+ | |||
+ | If you accidentally save a mistake, you can revert to an old version by using the **Old revisions** button. | ||
+ | |||
+ | You can also copy text from old revisions, for example, if you accidentally deleted a section. | ||
+ | ===== There' | ||
+ | |||
+ | If you find a problem with the PDF - missing pages, pages the wrong way round, unreadable pages etc - send me an email at < | ||
+ | |||
+ | ===== Tracking Page ===== | ||
+ | |||
+ | If you are working on a particular magazine, please update the [[magazines|tracking page]]. You can add an entry like **In progress (Tom)** or **Complete (Tom)** to let others know that you are working on, or have finished a magazine. Only use **Complete** when you have entirely finished, including formatting. | ||
===== Ready to go! ===== | ===== Ready to go! ===== | ||
- | When you are ready to start editing, see the list of [[magazines]]! | + | When you are ready to start editing, see the list of [[magazines]]! |
+ | |||
+ | Thanks for helping out! |
instructions.txt · Last modified: 2020/04/18 20:49 by sbw