From 6e3480b56d8962592e946f779ed9249749cf8dbb Mon Sep 17 00:00:00 2001 From: mickeyl Date: Sat, 17 May 2003 13:03:18 +0000 Subject: For Zecke: script assisting in making help file skeletons (took me an hour - like i said :-) --- (limited to 'scripts') diff --git a/scripts/mkHelpSkeleton b/scripts/mkHelpSkeleton new file mode 100755 index 0000000..ffb21c2 --- a/dev/null +++ b/scripts/mkHelpSkeleton @@ -0,0 +1,118 @@ +#!/usr/bin/env python +""" +This skript creates a help skeleton for a certain application +(C) Michael 'Mickey' Lauer who did this even if he had a lot of other stuff to do... +""" + +import os +import sys + +COUNTRYCODES = "da de en fr nl pl hu no pt it pt_BR ja sl zh_CN es ko zh_TW".split() +OPIEDIR = os.environ["OPIEDIR"] + +#Package: opie-appskey-help-en +#Files: help/en/html/opie-appskey.html +#Priority: optional +#Section: opie/onlinedoc +#Maintainer: ljp +#Architecture: arm +#Version: $QPE_VERSION-$SUB_VERSION +#Depends: opie-appskey +#License: GPL +#Description: Application Key help files (english) + +def doit( name, cc ): + """Create a help skeleton corresponding to a package described by a desktop file.""" + + desktop = {} + for line in file( name ): + try: + key, value = line.split( '=' ) + except ValueError: + pass + else: + desktop[key.strip()] = value.strip() + + try: + application = desktop["Exec"] + except: + fail( "No Exec given in .desktop file" ) + + print "Generating help skeleton for application '%s'..." % application + helpdirname = "%s/help/%s/html" % ( OPIEDIR, cc ) + helpappdirname = "%s/%s" % ( helpdirname, application ) + makecontrol( helpdirname, application, cc, desktop ) + makedir( helpappdirname ) + makehtml( helpdirname, application, cc, desktop ) + +#------------------------------------------------------# +def makehtml( directory, application, cc, desktop ): + """Creates the help template file.""" + + helpfilename = "%s/opie-%s.html" % ( directory, application ) + print "Creating help file '%s'" % helpfilename + h = file( helpfilename, "w" ) + print >> h, """ + + %s + +

%s

+ + +""" % ( application, application ) + +#------------------------------------------------------# +def makecontrol( directory, application, cc, desktop ): + """Creates the .control file.""" + + controlfilename = "%s/opie-%s-help-%s.control" % ( directory, application, cc ) + print "Creating control file '%s'" % controlfilename + c = file( controlfilename, "w" ) + print >> c, "Package: opie-%s-help-%s" % ( application, cc ) + print >> c, "Files: help/%s/html/opie-%s.html help/%s/html/%s" % ( cc, application, cc, application ) + print >> c, "Priority: optional" + print >> c, "Section: opie/onlinedoc" + print >> c, "Maintainer: %s" % desktop.get( "Maintainer", "Team Opie " ) + print >> c, "Version: $QPE_VERSION-$SUB_VERSION" + print >> c, "Depends: opie-%s" % application + print >> c, "License: GPL" + print >> c, "Description: %s help files (%s)" % ( application, cc ) + +#------------------------------------------------------# +def makedir( name ): + """Creates a directory.""" + + print "Creating directory '%s'" % name + if not os.path.exists( name ): os.mkdir( name ) + +#------------------------------------------------------# +def fail( reason ): + """Fails with a reason.""" + print reason + sys.exit( -1 ) + +#------------------------------------------------------# +def checkUsage( args ): + """Checks calling syntax.""" + + if len( args ) < 2: + fail( """ +Usage: %s .desktop [countrycode] + +If no countrycode is given, defaults to 'en' +If countrycode 'all' is given, generates skeletons +for all known countrycodes: %s""" % ( args[0], ", ".join( COUNTRYCODES ) ) ) + +#------------------------------------------------------# + +if __name__ == "__main__": + checkUsage( sys.argv ) + + if len ( sys.argv ) == 2: + doit( sys.argv[1], "en" ) + elif len( sys.argv ) == 3: + if sys.argv[2] == "all": + [ doit( sys.argv[1], x ) for x in split() ] + else: + doit( sys.argv[1], sys.argv[2] ) -- cgit v0.9.0.2