Difference between revisions of "Folios - Examples"
m (→Disclaimer: Added thanks to Rick Bisbee.) |
(→Folio of jpg scans: Updated for Folios v2.07) |
||
Line 12: | Line 12: | ||
[[Image:Folio-JPG-example.png]] | [[Image:Folio-JPG-example.png]] | ||
− | In this folio, the jpg images have been automatically named by the scanner which created them, and you will note that the files are conveniently datestamped in the order in which they were scanned. Therefore they did not need renaming. However, if extra pages needed to be added or inserted within the sequence, they could be easily renamed | + | In this folio, the jpg images have been automatically named by the scanner which created them, and you will note that the files are conveniently datestamped in the order in which they were scanned. Therefore they did not need renaming. However, if extra pages needed to be added or inserted within the sequence, they could be easily renamed. The filenames themselves are immaterial except they must sort in the desired order. |
This folio contains seven pages, and the page numbers displayed in the folio's window title conveniently agree with the page numbers on the typewritten sources. Note that there is no practical limit to the number of pages that can be held in a folio. | This folio contains seven pages, and the page numbers displayed in the folio's window title conveniently agree with the page numbers on the typewritten sources. Note that there is no practical limit to the number of pages that can be held in a folio. | ||
− | The folio's '''index.php''' file has been created from ''' | + | The folio's '''index.php''' file has been created from '''init.php''' distributed with [[Folios]] v2.07 with $mediaID edited according to the instructions. |
− | The | + | The pdf file was also created by the scanner, but with all pages concatenated into one document. Since it has a pdf suffix, it does not form part of the folio sequence. It is accessed (downloaded) from a link in the folio's cover page, and opens in a new window. |
+ | |||
+ | The cover page for this folio is very simple, as shown below. It contains only html code (at the time of writing) and could therefore have been named as 00-cover.html to describe its contents more appropriately. Changing the file suffix would have no impact on folio operation. | ||
<pre> | <pre> | ||
− | <P><A class=snlink href=" | + | <P> <A class=snlink href="20100216172910600.pdf" target=_download>Download PDF (1.4MB)</A></P> |
− | + | <HR> | |
− | Download PDF (1.4MB)</A></P> | + | <P> This is the cover page. To read Howard's notes, open the pages using |
− | <DIV class=folio><p> | + | the buttons above or download the entire folio in one file.</P> |
+ | <DIV class=folio> | ||
+ | <p><b>Relevance to this site:</b> Mercy Clare, daughter of Samuel Clare and his wife | ||
+ | Eliza Osborne married my grandfather Sidney George Clist shortly after he emigrated | ||
+ | to New Zealand in 1910.</p> | ||
+ | <p>Roger Clist</p> | ||
+ | </DIV> | ||
</pre> | </pre> | ||
Revision as of 02:59, 24 April 2011
This page contains two examples of Folios in a working site. The folders displayed on this page are of a local PC copy of the server's filesystem, with the TNG root being at D:\Webs\Roots.
This page describes an early version of the folios technology, and needs updating. The examples reached by the links have now been upgraded to v2.07, so the details below are incorrect in several places. The images and their descriptions will be updated in the near future. In the meantime, for folio Version 2, substitute folio.php for docview.php, and note that index.php is derived from init.php in the folios distribution download.
Folio of jpg scans
The following image shows the files used to create a simple folio of jpg scans of typewritten pages. This folio "Howard Clare's Notes" may be browsed at The Clist Connections.
In this folio, the jpg images have been automatically named by the scanner which created them, and you will note that the files are conveniently datestamped in the order in which they were scanned. Therefore they did not need renaming. However, if extra pages needed to be added or inserted within the sequence, they could be easily renamed. The filenames themselves are immaterial except they must sort in the desired order.
This folio contains seven pages, and the page numbers displayed in the folio's window title conveniently agree with the page numbers on the typewritten sources. Note that there is no practical limit to the number of pages that can be held in a folio.
The folio's index.php file has been created from init.php distributed with Folios v2.07 with $mediaID edited according to the instructions.
The pdf file was also created by the scanner, but with all pages concatenated into one document. Since it has a pdf suffix, it does not form part of the folio sequence. It is accessed (downloaded) from a link in the folio's cover page, and opens in a new window.
The cover page for this folio is very simple, as shown below. It contains only html code (at the time of writing) and could therefore have been named as 00-cover.html to describe its contents more appropriately. Changing the file suffix would have no impact on folio operation.
<P> <A class=snlink href="20100216172910600.pdf" target=_download>Download PDF (1.4MB)</A></P> <HR> <P> This is the cover page. To read Howard's notes, open the pages using the buttons above or download the entire folio in one file.</P> <DIV class=folio> <p><b>Relevance to this site:</b> Mercy Clare, daughter of Samuel Clare and his wife Eliza Osborne married my grandfather Sidney George Clist shortly after he emigrated to New Zealand in 1910.</p> <p>Roger Clist</p> </DIV>
Folio of html pages
The following image shows the files used to create a more complex folio of html pages created from source documents. Some of the folio pages have links to subpages (having their own images) and the entire file bundle is neatly contained within the folio. This folio "The Rossiter Report (Part 1)" may be browsed at The Clist Connections.
In this folio, the html pages have been individually named with a numeric prefix to ensure that they will be served in the desired order. A cover page starts the sequence. Note that each html page in this ordered set is incomplete in itself (in that it comprises only body text without <head> and <body> tags) being designed to be served by the folio.php script.
You can exercise considerable creativity in your folio cover and individual folio pages. In this example some of the folio pages contain <a href> links to other pages (a) within the folio, (b) within the site but outside the folio, and (c) to pages in external sites. The pages are relatively simple in themselves, but draw upon the site's CSS styles.
Note that the he folio's index.php file contains a line
$exclude[] = ".php";
as the php files in the folder are subpages of two of the folio's html files (pages 1 and 7), and their own subsidiary files (jpg images) are held in the folio's images folder (for tidiness) along with images belonging to the folio pages. This structure enables the entire folio to be copied/zipped, etc. in one bundle.
Image manipulation
When you are working with large numbers of scanned images of identical size such as jpg scans of historic papers, it is often helpful to manipulate them (crop, cut, resize, rename, add borders, adjust brightness, contrast, etc.) using FastStone Photo Resizer or IrfanView or similar program with batch mode options.
Disclaimer
The information provided in this page is "all care, but no responsibility" courtesy Roger Clist, who is extremely grateful to Rick Bisbee for developing the Folios facilty.
See Also
- Folios - the main page which describes the installation and implementation of the Folios facility
- Folios - Family Bible Pages shows how a Histories page can contain a folio of Bible page images (hopefully this page will be written up, based on an example at The Clist Connections which still uses docview.php)