# This python script generates the extra files needed for the frames # version of the manual. It generates the files: # indexframes.html, contents.html and title.html # Output is based on html files created by Michael Rhoades # Script written by Andres Cabrera June 2006 # Licensed under the GPL licence version 3 or later import sys from xml.dom import minidom from __future__ import print_function version = sys.argv[1:] if (len(version)==0): version=[''] indexframesFile = open('html/indexframes.html','w') creditsFile = open('html/credits.html','w') titleFile = open('html/title.html','w') contentsFile = open('html/contents.html','w') indexFile = open('html/index.html','r') index = indexFile.read() indexFile.seek(0) indexparse = minidom.parse(indexFile) frameLink = '''

Frames Version

''' s = '''

The Canonical Csound Reference Manual

''' titleEnd = index.find(s) + len(s) + 1 if (index[titleEnd:titleEnd+len(frameLink)]==frameLink): print '''************************************** Warning: index.html already processed! **************************************''' # indexframes.html ----------------------------------------- indexframesFile.write('''\n\n Csound ''' +version[0]+ ''' Manual - Frames Version <body> <p>This page uses frames, but your browser doesn\'t support them.</p> </body> ''') indexframesFile.close() # credits.html ----------------------------------------- creditsFile.write('''\n \n ''') creditsFile.write(index[index.find('
')+106]) creditsFile.write('
\n \n') creditsFile.close() # title.html ----------------------------------------- titleFile.write('''\n\n The Canonical Csound Reference Manual\n

The Canonical Csound Reference Manual
| A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | R | S | T | U | V | W | X | Z |
Score Statements | GEN Routines | Quick Reference

\n\n''') titleFile.close() # contents.html ----------------------------------------- contentsFile.write(''' Contents
''') #routine to find the toc navheader = indexparse.getElementsByTagName('div') i = 0 while (navheader[i]!=''): #print navheader[i].attributes.keys() if (len(navheader[i].attributes.keys())!=0): if (navheader[i].attributes.keys()[0]=='class'): #print navheader[i].attributes['class'].value if(navheader[i].attributes['class'].value == 'toc'): break i += 1 toc = navheader[i] sections = toc.getElementsByTagName('span') a = toc.getElementsByTagName('a') for j in range(len(a)): if (a[j].attributes['href'].value=='OpcodesTop.html'): overview=a[j].parentNode.parentNode.nextSibling.nextSibling elif (a[j].attributes['href'].value=='ScoregensTop.html'): scoregens=a[j].parentNode.parentNode.nextSibling.nextSibling break #print overview.toxml().encode('utf-8') # Routine to make titles bigger and black, except Appendices for j in range(len(sections)): #print "---------\n", sections[j].toxml() #raw_input() if ((sections[j].attributes['class'].value!='section')and (sections[j].attributes['class'].value!='chapter')and (sections[j].attributes['class'].value!='appendix')and (sections[j].attributes['class'].value!='refentrytitle')and (sections[j].attributes['class'].value!='refpurpose')and (sections[j].attributes['class'].value!='quote')and (sections[j].attributes['class'].value!='emphasis')): print "--------Title:", sections[j].childNodes[1].firstChild.toxml().encode('utf-8') font = minidom.Element('font') font.setAttribute('size','4') font.setAttribute('color','Black') font.appendChild(minidom.Element('br')) if (sections[j].childNodes[1].childNodes[0].toxml().encode('utf-8')=='Glossary'): font.appendChild(sections[j].childNodes[1].cloneNode(True)) else: font.appendChild(sections[j].childNodes[1].childNodes[0].cloneNode(True)) font.appendChild(minidom.Element('br')) #print sections[j].firstChild.toxml().encode('latin-1') #print font.toxml().encode('latin-1') parent = sections[j].parentNode parent.appendChild(font) parent.removeChild(sections[j]) #spanElement = sections[j].getElementsByTagName('span') #try: #sections[j].removeChild(spanElement) #except: #print "No span for", sections[j].toxml() #print sections[j].toxml().encode('latin-1') #print font.toxml().encode('latin-1') elif (sections[j].attributes['class'].value=='appendix'): font = minidom.Element('font') font.setAttribute('size','4') font.appendChild(sections[j].childNodes[1].cloneNode(True)) font.appendChild(minidom.Element('br')) #print sections[j].firstChild.toxml().encode('latin-1') #print font.toxml().encode('latin-1') parent = sections[j].parentNode parent.appendChild(font) parent.removeChild(sections[j]) #print sections[j].toxml().encode('latin-1') #print font.toxml().encode('latin-1') else: #print sections[j].toxml().encode('latin-1') parent = sections[j].parentNode newNode = sections[j].getElementsByTagName('a') font = minidom.Element('font') font.setAttribute('size','2') #font.setAttribute('color','Black') #font.appendChild(minidom.Element('br')) #if (sections[j].attributes['class'].value!='refpurpose' and #sections[j].attributes['class'].value!='refentrytitle' and #sections[j].attributes['class'].value!='quote' and #sections[j].attributes['class'].value!='emphasis'): if newNode != []: # font.appendChild(newNode[0].cloneNode(True)) parent.appendChild(newNode[0].cloneNode(True)) # parent.appendChild(font) parent.removeChild(sections[j]) #print sections[j].toxml().encode('latin-1') #print toc.toxml() #.encode('latin-1') # routine to remove text description from opcode entries and # add alphabetical references and letters unwantedtext = overview.getElementsByTagName('dt') alphabetcaps = [] alphabet = [] for num in range(65,93): alphabetcaps.extend(chr(num)) alphabet.extend(chr(num+32)) count = -1 for text in unwantedtext: if count==15 or count==23: count = count + 1 #There is no 'Q' or 'Y' #print "text: ", text.toxml() text.removeChild(text.childNodes[0]) #text.appendChild(minidom.Element('br')) #print "Unwanted: ", text.toxml() node = text.getElementsByTagName('a') if ((node[0].firstChild.toxml().encode('utf-8')[0]==alphabet[count+1]) or(node[0].toxml().encode('utf-8')[0]==alphabetcaps[count+1])): count += 1 string = '' + alphabetcaps[count] + '' #print "string:", string letter = minidom.parseString(string) text.insertBefore(minidom.Element('br'), text.firstChild) text.insertBefore(letter.firstChild, text.firstChild) print "unwanted2: ", text.firstChild #print text.toxml().encode('latin-1') # routine to remove text description from score statement and GEN entries unwantedtext = scoregens.getElementsByTagName('dt') for text in unwantedtext: node = text.firstChild if node.nodeType == minidom.Node.ELEMENT_NODE and node.tagName == 'a': text.removeChild(text.childNodes[1]) text.appendChild(minidom.Element('br')) # Routines to remove indentation #dt = toc.getElementsByTagName('dt') #for j in range(len(dt)): #spanElement = dt.getElementsByTagName('span') #if spanElement.attributes['class'].value == 'section': #break #parent = dt[j].parentNode #print parent.toxml() #for k in range(len(dt[j].childNodes)): #parent.insertBefore(dt[j].firstChild ,dt[j]) #parent.removeChild(dt[j]) #dl = toc.getElementsByTagName('dl') #for j in range(len(dl)): #parent = dl[j].parentNode #for k in range(len(dl[j].childNodes)): #parent.insertBefore(dl[j].firstChild ,dl[j]) #parent.removeChild(dl[j]) #dd = toc.getElementsByTagName('dd') #for j in range(len(dd)): #parent = dd[j].parentNode #if (parent.nodeName!='dd'): #for k in range(len(dd[j].childNodes)): #parent.insertBefore(dd[j].firstChild ,dd[j]) #parent.removeChild(dd[j]) #print toc #print toc.toxml().encode('latin-1') toc = toc.toxml().encode('utf-8') contentsFile.write(toc) contentsFile.close() # Modify index.html to include a link to the frames version if (index[titleEnd:titleEnd+len(frameLink)]!=frameLink): newindex = index[0:titleEnd]+ frameLink newindex += index[titleEnd:] indexFile.close() indexFile = open('html/index.html','w') indexFile.seek(0) indexFile.write(newindex) indexFile.close()