###############################################################################
###############################################################################

 About the Source Code for Andrew's Cotswold Morris Dance Detailed Notes

	by Andrew Hardwick, http://duramecho.com,
	
	Written 2002/8/9, typo corrections 2007/7/22, CC licence added 2017/4/10.

	Released under GNU Public Licence (GPL)
	and Creative Common Attribution-ShareAlike (CC by-sa) licence.

###############################################################################
###############################################################################

Contents List

	CotswoldDetailedNotesEditingFormatX.rtf where X is a number

		The vital bit - the actual information. X is the version number.

	CotsNotesWebsiteGenerator.pl

		The program/script, written in Perl, for converting the
		information in M$ Word 2k HTML output format to single &
		multiple page HTML versions.
	
	CotswoldDetailedNotesPrinterTemplate.rtf
	
		The template for formatting the information for printing.
		
	ReadMe.txt
	
		This document.
	
###############################################################################

How to Generate Web Pages from it

	Open the RTF file with the information in it in M$ Word 2k (or another
	RTF to HTML converter but you might need to tweak the converter program's
	'ExtractParagraphsFromWordHtm' function to match the styling of HTML
	produced by it) and save as a web page (*.htm file). (If using Word
	2k, convert the small caps heading styles to normal text first as Word
	2k's small caps to HTML export does not work.)

	Run the Perl program (it takes no parameters) with the *.htm file
	in the current working directory. Output will be to that
	directory.

###############################################################################

How to Generate Printer Formatted RTF from it

	Copy CotswoldDetailedNotesTemplate.rtf to CotswoldDetailedNotes.rtf and
	open it in a wordproccessor.
	
	Also open the RTF file containing the information.
	
	Copy the all the information from the latter into the former overwriting
	the line "1. Insert main body here.".
	
	Cut the first line (the one with the version information) from what you
	have just pasted and paste above overwriting the "2. Insert version info
	here..." line.
	
	Refresh the table of contents (if the page numbering in it has started from
	'1' instead of '2' or more then the wordprocessor has forgotten that
	inserting a table of contents changes the text positioning so refresh
	it again).

###############################################################################

FAQs

	Why only Cotswold Morris Dancing?
	
		I do more Balkan / International Folk Dancing that Morris so why have
		I only published notes like this for Cotswold Morris?
		
			1. Cotswold Morris is very formularised (because it is a snapshot
			of how dances were done in one area at one time in history) so
			it is possibly to make a usefully comprehensive set of notes
			without getting into thousands of dances. There are about 300 known
			traditional Cotswold dances of which about half are probably in
			common use compared to at least 3000 traditional Balkan dances
			known from Romania alone with more being choreographed all the
			time.

			2. Unlike Border & Molly Morris, the recording of about 300 dances
			by ethnomusicologists in the early 1900s resulted in Cotswold dances
			usually being danced in very similar ways by different sides. I
			also have handwritten notes for about 20 Border dances and a few
			Molly ones but there is so much variation in choreographies between
			teams that there is little point me putting them on the web.

			3. Although there are books containing large collections of
			Cotswold Dances (Sharpe's & Butler's), they are not currently
			available in print in open circulation unlike for Scottish
			Country Dancing (Pilling's little green book is excellent - it only
			costs a few pounds & is pocket/sporan sized yet contains the
			figures for over 600 dances with more in each subsequent edition).
	
	Why are the version numbers so high?
	
		I have not bothered with 'release.draft' style numbering. Instead I just
		up the number whenever I turn the computer off having altered it.
	
	Why is the raw data in RTF not a simple format like POD or HTML?
	
		Because I like the Outlining editing mode whereby I can see the
		document just as to level headings then expand each of those
		independently to see the next level headings under it and so on down
		to the plain text paragraphs and also move sections around by heading
		groupings at any level. It is very useful for a hierarchically
		structured document.
		
		Unfortunately the only wordprocessor knew of for WinNT that does
		this well happens to be M$ Word. It was one of those good features that
		was put in M$ Word 4 for Mac (the only good M$ program in my opinion - 
		lots of useful features such as stylesheets and Normal/Outline/Page-View 		editing modes rather than gimmicky or lock-in-encouraging one, and the
		whole program would fit uncompressed on a 1.44 Mb floppy disk; ever
		since then M$ have made Word less useable with each subsequent edition,
		for example Outlining mode is now a hidden menu item & Page-View - 
		formatting for paper not screen - is the default with the default
		picture insertion method designed so that after someone has naively
		used it, the document is no longer properly viewable in any other mode).
		The only file formats that all versions >= Mac4 of M$ Word will read are
		M$ Word Doc & RTF. Out of those, RTF is the easiest to support in other
		programs so I chose to use that.
			
	What is the format of the temporary file 'Paragraphs.txt'?
	
		Style of paragraph 1\n
		Text of paragraph 1\n
		Style of paragraph 2\n
		Text of paragraph 2\n
		etc.

	What structure must the raw data be in for the converter program to work?

		The first line is used as a title for the single page HTML version
		& printer version. It needs to contain "Version <version number>." and
		"Updated <date>" which are extracted and used for footer information
		for the multipage version.
		
		The function of other lines is determined by paragraph style:
		
			heading 1: Tradition name.
		
			heading 2: Dance name.
			
			heading 3: General purpose subsubheading.
			
			normal: Plain text. (In the multipage version, ignored unless
			under at least a heading 2.)
			
			Pre: Like normal but to be treated as preformatted
			(non-proportionally spaced) text.

		The 'Introduction' & '... General Instructions' sections are written
		as if they were traditions and the 'Common Features' section of each
		tradition is written as if it were a dance because they are
		treated the same when creating the output other than the
		non-hierarchical links at bottom of the pages of the multipage
		version (which are automatically adapted when those particular
		tradition & dance names are found).
	
	How does one change the outputted HTML format?
	
		Edit the Perl script.
	
	Why did I write/release it?
	
		For learning dances myself / lest it useful to someone else.
		
	Why are the so many mistakes in the ReadMe file & program documentation?
	
		I can't be bothered to proofread them!
	
	What conditions can it be re-used & redistributed under?
	
		GPL (GNU Public Licence) or CC BY-SA (Creative Commons
		Attribution-ShareAlike licence). Preferably GPL, as it gives more
		editing options to subsequent users, but CC BY-SA is okay too.
		I've allowed CC BY-SA in addition as the source code aspect
		included by a GPL distribution of this material is too difficult  
		for some people.
	
		CC BY-SA essentially means that you can do
		anything you like with it provided you don't stop others from doing
		likewise with derived works and don't blame me for any consequences
		It includes passing on the information about who wrote it  (I
		included that requirement so that readers can find their way
		back to my original copy if they want it).
		See http://creativecommons.org/licenses/by-sa/2.5/ for details.
	
		GPL is essentially the same but with extras, the main relevant
		one for this work being that source code etc., not just the resulting
		documents, should be distributed with it. That will give
		subsequent users the option of using the bulk page creation script
		etc. rather than just editing the results.
		See http://www.gnu.org/licenses/gpl.txt for details.
	
	Why the alias 'Duramecho'?
	
		When I first needed a non-university non-employer e'mail 
		account and tried to set up a free Yahoo one, I found that 'hardwick',
		my surname, was already taken. So was 'andrewhardwick', 'ajh',
		etc., even 'kciwdrah' so I split it into 'hard' & 'wick', translated
		each independantly into Esperanto, reassembled them and
		translittered the result into ASCII.
		Simple really!
			
###############################################################################

Thanks

	Thanks to all those in Lagabag Morris & elsewhere who taught me the dances.

###############################################################################
