Difference between revisions of "Folios - Examples"

From TNG_Wiki
Jump to navigation Jump to search
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 to arrange the folio in the desired order. The filenames themselves form no part in the folio's presentation, and the site visitor is unaware of their names.
+
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 '''folio_index_template.php''' v1.2 with allowable file types restricted to '''jpg''' only. The pdf file was also created by the scanner, but with all pages concatenated into one document. It is accessed (downloaded) from a link in the folio's cover page, and opens in a new window.
+
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 media body-text for this folio (at the time of writing) is very simple, as follows.
+
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="folios/Howard_Clare1/index.php" target=_self>View Document Pages</A>
+
<P>&nbsp;<A class=snlink href="20100216172910600.pdf" target=_download>Download PDF (1.4MB)</A></P>
<A class=snlink href="folios/Howard_Clare1/20100216172910600.pdf" target=_download>
+
<HR>
Download PDF (1.4MB)</A></P>
+
<P>&nbsp;This is the cover page. To read Howard's notes, open the pages using
<DIV class=folio><p>Cover page text, etc.</p></DIV>
+
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.

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. 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.

Folio-HTML-example.png

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