I took Rob Landley's nice "menuconfig2html.py" script from
http://landley.net/hg/kdocs and modified it to produce MediaWiki output for coreboot's Option List at http://coreboot.org/Coreboot_Options. The attached patch exchanges our old ("newconfig") optionlist script with the new one. Signed-off-by: Stefan Reinauer <stepan@coresystems.de> Acked-by: Patrick Georgi <patrick.georgi@coresystems.de> git-svn-id: svn://svn.coreboot.org/coreboot/trunk@5101 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
This commit is contained in:
Stefan Reinauer
Stefan Reinauer
parent
5543c66cca
commit
f64b42ed7a
|
|
@ -1,10 +1,9 @@
|
|||
#
|
||||
# Copyright (C) 2005 Stefan Reinauer <stepan@coresystems.de>
|
||||
# Copyright (C) 2010 coresystems GmbH
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; either version 2 of the License, or
|
||||
# (at your option) any later version.
|
||||
# the Free Software Foundation; version 2 of the License.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
|
|
@ -16,17 +15,12 @@
|
|||
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
#
|
||||
|
||||
all: html wiki
|
||||
|
||||
html:
|
||||
./mkOptionList.py
|
||||
@#saxon Options.xml Options.xsl > Options.html
|
||||
xsltproc Options.xsl Options.xml > Options.html
|
||||
SVNVERSION := $(shell LC_ALL=C svnversion -cn ../.. | sed -e "s/.*://" -e "s/\([0-9]*\).*/\1/" | grep "[0-9]" || LC_ALL=C svn info . | grep ^Revision | sed "s/.*[[:blank:]]\+\([0-9]*\)[^0-9]*/\1/" | grep "[0-9]" || echo unknown)
|
||||
|
||||
wiki:
|
||||
./mkOptionList.py
|
||||
xsltproc Options-wiki.xsl Options.xml > Options.wiki
|
||||
all:
|
||||
cd ../..; util/optionlist/kconfig2wiki src/Kconfig $(SVNVERSION) > util/optionlist/Options.wiki
|
||||
|
||||
clean:
|
||||
rm -rf Options.xml Options.html Options.wiki
|
||||
rm -rf Options.wiki
|
||||
|
||||
|
|
|
|||
|
|
@ -1,47 +0,0 @@
|
|||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright (C) 2006 Stefan Reinauer <stepan@coresystems.de>
|
||||
Copyright (C) 2006 Uwe Hermann <uwe@hermann-uwe.de>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
-->
|
||||
|
||||
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
|
||||
|
||||
<xsl:output method="text"
|
||||
encoding="utf-8"
|
||||
indent="yes" />
|
||||
|
||||
<xsl:template match="/">
|
||||
This is an automatically generated list of '''coreboot v2 compile-time options'''.
|
||||
|
||||
Last update: <xsl:value-of select="//creationdate"/>.
|
||||
|
||||
{| border="0" style="font-size: smaller"
|
||||
|- bgcolor="#6699dd"
|
||||
! align="left" | Option
|
||||
! align="left" | Comment
|
||||
! align="left" | Default
|
||||
! align="left" | Export
|
||||
! align="left" | Format
|
||||
<xsl:for-each select="options/option">
|
||||
|- bgcolor="#eeeeee"
|
||||
| <xsl:value-of select="@name"/> || <xsl:value-of select="comment"/> || <xsl:value-of select="default"/> || <xsl:value-of select="export"/> || <xsl:value-of select="format"/>
|
||||
</xsl:for-each>
|
||||
|
||||
|}
|
||||
|
||||
</xsl:template>
|
||||
</xsl:stylesheet>
|
||||
|
|
@ -1,73 +0,0 @@
|
|||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright (C) 2005 Florian Zeitz <florian-zeitz@lycos.de>
|
||||
Copyright (C) 2005 Stefan Reinauer <stepan@coresystems.de>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
-->
|
||||
|
||||
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
|
||||
|
||||
<!--<xsl:choose>
|
||||
<xsl:when test="system-property('xsl:vendor')='Transformiix'">
|
||||
-->
|
||||
<xsl:output method="xml"
|
||||
doctype-public="PUBLIC -//W3C//DTD XHTML 1.0 Strict//EN"
|
||||
doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
|
||||
encoding="utf-8"
|
||||
indent="yes" />
|
||||
<!--
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:output method="xhtml"
|
||||
doctype-public="PUBLIC -//W3C//DTD XHTML 1.0 Strict//EN"
|
||||
doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
|
||||
encoding="utf-8"
|
||||
indent="yes" />
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
-->
|
||||
|
||||
<xsl:template match="/">
|
||||
<html>
|
||||
<head>
|
||||
<title>Coreboot Options</title>
|
||||
</head>
|
||||
<body>
|
||||
<h2>Coreboot Options</h2>
|
||||
<p>This is an automatically generated list of coreboot compile time
|
||||
options. Created at <xsl:value-of select="//creationdate"/>.</p>
|
||||
<table border="1">
|
||||
<tr bgcolor="#0975a7">
|
||||
<th align="left">Option</th>
|
||||
<th align="left">Comment</th>
|
||||
<th align="left">Default</th>
|
||||
<th align="left">Export</th>
|
||||
<th align="left">Format</th>
|
||||
</tr>
|
||||
<xsl:for-each select="options/option">
|
||||
<tr>
|
||||
<td><xsl:value-of select="@name"/></td>
|
||||
<td><xsl:value-of select="comment"/></td>
|
||||
<td><xsl:value-of select="default"/></td>
|
||||
<td><xsl:value-of select="export"/></td>
|
||||
<td><xsl:value-of select="format"/></td>
|
||||
</tr>
|
||||
</xsl:for-each>
|
||||
</table>
|
||||
</body>
|
||||
</html>
|
||||
</xsl:template>
|
||||
</xsl:stylesheet>
|
||||
|
|
@ -1,46 +1 @@
|
|||
I would like to contribute the following to the coreboot wiki in case
|
||||
it's useable:
|
||||
|
||||
1. I have written a rather small Python script to convert the Options.lb
|
||||
into an XML file which is much more useable for the web in most cases.
|
||||
|
||||
2. I have written a XSLT to convert the XML file to (X)HTML to be able
|
||||
to present it as a table.
|
||||
|
||||
Florob (Florian Zeitz <florian-zeitz@lycos.de>)
|
||||
|
||||
|
||||
ChangeLog
|
||||
---------
|
||||
|
||||
* 2005-03-19 stepan
|
||||
- fix xml stylesheet to work with xsltproc and saxon
|
||||
- add Makefile
|
||||
- make script a bit more verbose
|
||||
|
||||
* 2005-03-15 florob
|
||||
- Initial version
|
||||
|
||||
|
||||
License
|
||||
-------
|
||||
|
||||
Copyright (C) 2005 Florian Zeitz <florian-zeitz@lycos.de>
|
||||
Copyright (C) 2005-2006 Stefan Reinauer <stepan@coresystems.de>
|
||||
Copyright (C) 2006 Uwe Hermann <uwe@hermann-uwe.de>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
|
||||
|
||||
This script creates the page http://www.coreboot.org/Coreboot_Options
|
||||
|
|
|
|||
|
|
@ -0,0 +1,133 @@
|
|||
#!/usr/bin/python
|
||||
#
|
||||
# kconfig2wiki - Kconfig to MediaWiki converter for
|
||||
# http://www.coreboot.org/Coreboot_Options
|
||||
#
|
||||
# Copyright (C) 2010 coresystems GmbH
|
||||
# based on http://landley.net/kdocs/make/menuconfig2html.py
|
||||
# Copyright (C) by Rob Landley
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; version 2 of the License
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program; if not, write to the Free Software
|
||||
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
#
|
||||
|
||||
helplen = 0
|
||||
extra_chapters = 0
|
||||
|
||||
##
|
||||
## Remove quotes from Kconfig string options
|
||||
##
|
||||
def zapquotes(str):
|
||||
if str[0]=='"': str = str[1:str.rfind('"')]
|
||||
return str
|
||||
|
||||
##
|
||||
## Escape HTML special characters
|
||||
##
|
||||
def htmlescape(str):
|
||||
return str.strip().replace("&","&").replace("<","<").replace(">",">")
|
||||
|
||||
##
|
||||
## Process Kconfig file
|
||||
##
|
||||
def readfile(filename):
|
||||
import sys
|
||||
global helplen
|
||||
|
||||
source=filename.replace("src/","").replace("/Kconfig","").replace("Kconfig","toplevel")
|
||||
|
||||
try:
|
||||
lines = open(filename).read().split("\n")
|
||||
except IOError:
|
||||
sys.stderr.write("File %s missing\n" % filename)
|
||||
return
|
||||
config = None
|
||||
description = None
|
||||
configtype = None
|
||||
for i in lines:
|
||||
if helplen:
|
||||
i = i.expandtabs()
|
||||
if not len(i) or i[:helplen].isspace():
|
||||
sys.stdout.write("%s\n" % htmlescape(i))
|
||||
continue
|
||||
else:
|
||||
helplen = 0
|
||||
sys.stdout.write("||\n")
|
||||
|
||||
words = i.strip().split(None,1)
|
||||
if not len(words): continue
|
||||
|
||||
if words[0] in ("config", "menuconfig"):
|
||||
config = words[1]
|
||||
description = ""
|
||||
elif words[0] in ("bool", "boolean", "tristate", "string", "hex", "int"):
|
||||
configtype = htmlescape(zapquotes(words[0]))
|
||||
if len(words)>1: description = htmlescape(zapquotes(words[1]))
|
||||
elif words[0]=="prompt":
|
||||
description = htmlescape(zapquotes(words[1]))
|
||||
elif words[0] in ("help", "---help---"):
|
||||
sys.stdout.write("|- bgcolor=\"#eeeeee\"\n")
|
||||
sys.stdout.write("| %s || %s || %s || %s || \n" % (config,source,configtype,description) )
|
||||
helplen = len(i[:i.find(words[0])].expandtabs())
|
||||
elif words[0] == "comment":
|
||||
sys.stdout.write("|- bgcolor=\"#eeeeee\"\n")
|
||||
sys.stdout.write("| || || (comment) || || %s ||\n" % htmlescape(zapquotes(words[1])))
|
||||
elif words[0]=="menu":
|
||||
if len(words)>1:
|
||||
temp = htmlescape(zapquotes(words[1]))
|
||||
if extra_chapters:
|
||||
sys.stdout.write("== Menu: %s ==\n" % temp)
|
||||
sys.stdout.write("{| border=\"0\" style=\"font-size: smaller\"\n");
|
||||
sys.stdout.write("|- bgcolor=\"#6699dd\"\n")
|
||||
sys.stdout.write("! align=\"left\" | Option\n")
|
||||
sys.stdout.write("! align=\"left\" | Source\n")
|
||||
sys.stdout.write("! align=\"left\" | Format\n")
|
||||
sys.stdout.write("! align=\"left\" | Short Description\n")
|
||||
sys.stdout.write("! align=\"left\" | Description\n")
|
||||
else:
|
||||
# Don't start an extra chapter for a
|
||||
# new menu
|
||||
sys.stdout.write("|- bgcolor=\"#6699dd\"\n")
|
||||
sys.stdout.write("! align=\"left\" | Menu: %s || || || ||\n" % temp)
|
||||
elif words[0] == "endmenu":
|
||||
if extra_chapters:
|
||||
sys.stdout.write("|}\n")
|
||||
sys.stdout.write("\n")
|
||||
elif words[0] == "source":
|
||||
fn=zapquotes(words[1])
|
||||
readfile(fn)
|
||||
elif words[0] in ("default","depends", "select", "if", "endif", "#"): pass
|
||||
#else: sys.stderr.write("unknown: %s\n" % i)
|
||||
if helplen: sys.stdout.write("||\n")
|
||||
|
||||
def main():
|
||||
import sys, time
|
||||
|
||||
if len(sys.argv)!=3:
|
||||
sys.stderr.write("Usage: kconfig2wiki kconfigfile version\n")
|
||||
sys.exit(1)
|
||||
|
||||
sys.stdout.write("This is an automatically generated list of '''coreboot compile-time options'''.\n")
|
||||
sys.stdout.write("\nLast update: %s. (r%s)\n" % (time.strftime('%Y/%m/%d %H:%M:%S'),sys.argv[2]))
|
||||
sys.stdout.write("{| border=\"0\" style=\"font-size: smaller\"\n");
|
||||
sys.stdout.write("|- bgcolor=\"#6699dd\"\n")
|
||||
sys.stdout.write("! align=\"left\" | Option\n")
|
||||
sys.stdout.write("! align=\"left\" | Source\n")
|
||||
sys.stdout.write("! align=\"left\" | Format\n")
|
||||
sys.stdout.write("! align=\"left\" | Short Description\n")
|
||||
sys.stdout.write("! align=\"left\" | Description\n")
|
||||
readfile(sys.argv[1])
|
||||
sys.stdout.write("|}\n")
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
|
@ -1,141 +0,0 @@
|
|||
#!/usr/bin/python
|
||||
#
|
||||
# Copyright (C) 2005 Florian Zeitz <florian-zeitz@lycos.de>
|
||||
# Copyright (C) 2005 Stefan Reinauer <stepan@coresystems.de>
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; either version 2 of the License, or
|
||||
# (at your option) any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program; if not, write to the Free Software
|
||||
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
#
|
||||
|
||||
def xmlString(string):
|
||||
for i in range(len(string)-1):
|
||||
if string[i] == "&":
|
||||
string = string[:i] + "&" + string[i+1:]
|
||||
if string[i] == "<":
|
||||
string = string[:i] + "<" + string[i+1:]
|
||||
if string[i] == ">":
|
||||
string = string[:i] + ">" + string[i+1:]
|
||||
return string
|
||||
|
||||
def openInfile(filename):
|
||||
"getting the input from the inputfile (e.g. Options.lb)"
|
||||
infile = open(filename, "r")
|
||||
infile.seek(0)
|
||||
input = infile.readlines()
|
||||
infile.close()
|
||||
return input
|
||||
|
||||
def prepInput(input):
|
||||
"preparing the input for parsing (not really neccessary, but makes things simpler and doesnt take too long)"
|
||||
i = -1
|
||||
while True:
|
||||
i += 1
|
||||
if i >= len(input): break
|
||||
if input[i] == ("" or "\n"):
|
||||
input.pop(i)
|
||||
if input[i][0:1] == "\t":
|
||||
input[i] = input[i][1:]
|
||||
i = -1
|
||||
return input
|
||||
|
||||
def parseInput(input):
|
||||
"parse the output"
|
||||
output = ""
|
||||
for line in input:
|
||||
line = xmlString(line)
|
||||
if line[:6] == "define":
|
||||
output = output + '<option name="' + line[7:-1] + '">' + "\n"
|
||||
elif line[:3] == "end":
|
||||
output = output + '</option>' + "\n\n"
|
||||
elif line[:7] == "default":
|
||||
output = output + '<default>' + line[8:-1] + '</default>' + "\n"
|
||||
elif line[:6] == "format":
|
||||
output = output + '<format>' + line[7:-1] + '</format>' + "\n"
|
||||
elif line[:6] == "export":
|
||||
output = output + '<export>' + line[7:-1] + '</export>' + "\n"
|
||||
elif line[:7] == "comment":
|
||||
output = output + '<comment>' + line[8:-1] + '</comment>' + "\n"
|
||||
|
||||
return output
|
||||
|
||||
def parseArgv():
|
||||
"parse the given arguments"
|
||||
import sys
|
||||
|
||||
In = Out = False
|
||||
|
||||
if len(sys.argv) >= 2:
|
||||
if sys.argv[1] == ("-h" or "--help"):
|
||||
print "Syntax: mkOptionList.py [infile] [outfile]"
|
||||
else:
|
||||
In = True
|
||||
inFilename = sys.argv[1]
|
||||
if len(sys.argv) >= 3:
|
||||
if sys.argv[2] == ("-h" or "--help"):
|
||||
print "Syntax: mkOptionList.py [infile] [outfile]"
|
||||
else:
|
||||
Out = True
|
||||
outFilename = sys.argv[2]
|
||||
|
||||
if In and not Out:
|
||||
return inFilename
|
||||
elif In and Out:
|
||||
return inFilename, outFilename
|
||||
|
||||
|
||||
def main():
|
||||
import time
|
||||
if not parseArgv():
|
||||
inFilename = "../../src/config/Options.lb"
|
||||
outFilename = "Options.xml"
|
||||
else:
|
||||
inFilename, outFilename = parseArgv()
|
||||
|
||||
input = openInfile(inFilename)
|
||||
input = prepInput(input)
|
||||
output = parseInput(input)
|
||||
|
||||
print "mkOptionList.py: coreboot option list generator"
|
||||
print " input file : ", inFilename
|
||||
print " output file: ", outFilename
|
||||
|
||||
#opening the output file
|
||||
outfile = open(outFilename, "w", 0)
|
||||
|
||||
#write the beginning of the XML to the output file
|
||||
outfile.write('<?xml version="1.0"?>')
|
||||
outfile.write("\n")
|
||||
outfile.write('<?xml-stylesheet type="text/xsl" href="Options.xsl"?>')
|
||||
outfile.write("\n")
|
||||
outfile.write('<options>')
|
||||
outfile.write("\n")
|
||||
outfile.write('<creationdate>')
|
||||
outfile.write(time.strftime('%Y/%m/%d %H:%M:%S'))
|
||||
outfile.write('</creationdate>')
|
||||
outfile.write("\n")
|
||||
|
||||
|
||||
#write the parsed file to the output file
|
||||
outfile.write(output)
|
||||
|
||||
#write closing tags to the output file and close it
|
||||
outfile.write('</options>')
|
||||
outfile.write("\n")
|
||||
outfile.flush()
|
||||
outfile.close()
|
||||
|
||||
print "Done!"
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Loading…
Reference in New Issue