2012-10-05 23:28:47 +02:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
***************************************************************************
|
|
|
|
|
Help2Html.py
|
|
|
|
|
---------------------
|
|
|
|
|
Date : August 2012
|
|
|
|
|
Copyright : (C) 2012 by Victor Olaya
|
|
|
|
|
Email : volayaf at gmail dot com
|
|
|
|
|
***************************************************************************
|
|
|
|
|
* *
|
|
|
|
|
* 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. *
|
|
|
|
|
* *
|
|
|
|
|
***************************************************************************
|
|
|
|
|
"""
|
2014-04-19 00:48:56 +02:00
|
|
|
import re
|
2012-10-05 23:28:47 +02:00
|
|
|
|
|
|
|
|
__author__ = 'Victor Olaya'
|
|
|
|
|
__date__ = 'August 2012'
|
|
|
|
|
__copyright__ = '(C) 2012, Victor Olaya'
|
2013-10-01 20:52:22 +03:00
|
|
|
|
2012-10-05 23:28:47 +02:00
|
|
|
# This will get replaced with a git SHA1 when you do a git archive
|
2013-10-01 20:52:22 +03:00
|
|
|
|
2012-10-05 23:28:47 +02:00
|
|
|
__revision__ = '$Format:%H$'
|
|
|
|
|
|
2012-09-15 18:25:25 +03:00
|
|
|
import pickle
|
2013-09-12 13:19:00 +02:00
|
|
|
from processing.tools.system import *
|
2012-09-15 18:25:25 +03:00
|
|
|
import os
|
2013-09-23 13:31:47 +02:00
|
|
|
import codecs
|
2013-05-24 00:38:29 +02:00
|
|
|
|
2014-04-19 00:48:56 +02:00
|
|
|
ALG_DESC = 'ALG_DESC'
|
|
|
|
|
ALG_CREATOR = 'ALG_CREATOR'
|
|
|
|
|
ALG_HELP_CREATOR = 'ALG_HELP_CREATOR'
|
2012-09-15 18:25:25 +03:00
|
|
|
|
2014-04-19 00:48:56 +02:00
|
|
|
exps = [(r"\*(.*?)\*", r"<i>\1</i>"),
|
2014-04-19 22:04:24 +02:00
|
|
|
("``(.*?)``", r'<FONT FACE="courier">\1</FONT>'),
|
2014-04-19 00:48:56 +02:00
|
|
|
("(.*?)\n==+\n+?", r'<h2>\1</h2>'),
|
|
|
|
|
("(.*?)\n--+\n+?", r'<h3>\1</h3>'),
|
|
|
|
|
(r"::(\s*\n(\s*\n)*((\s+).*?\n)(((\4).*?\n)|(\s*\n))*)",r"<pre>\1</pre>"),
|
|
|
|
|
("\n+", "</p><p>")]
|
2013-10-01 20:52:22 +03:00
|
|
|
|
2012-09-15 18:25:25 +03:00
|
|
|
|
2014-04-19 00:48:56 +02:00
|
|
|
def getHtmlFromRstFile(rst):
|
|
|
|
|
with open(rst) as f:
|
2014-04-19 22:04:24 +02:00
|
|
|
lines = f.readlines()
|
2014-04-19 00:48:56 +02:00
|
|
|
s = "".join(lines)
|
|
|
|
|
for exp, replace in exps:
|
|
|
|
|
p = re.compile(exp)
|
|
|
|
|
s = p.sub(replace, s)
|
|
|
|
|
print s
|
|
|
|
|
return s
|
2014-04-19 22:04:24 +02:00
|
|
|
|
2014-04-19 00:48:56 +02:00
|
|
|
def getHtmlFromHelpFile(alg, helpFile):
|
|
|
|
|
if not os.path.exists(helpFile):
|
|
|
|
|
return None
|
|
|
|
|
alg = alg
|
|
|
|
|
f = open(helpFile, 'rb')
|
|
|
|
|
descriptions = pickle.load(f)
|
|
|
|
|
s = '<html><body><h2>Algorithm description</h2>\n'
|
|
|
|
|
s += '<p>' + getDescription(ALG_DESC, descriptions) + '</p>\n'
|
|
|
|
|
s += '<h2>Input parameters</h2>\n'
|
|
|
|
|
for param in alg.parameters:
|
|
|
|
|
s += '<h3>' + param.description + '</h3>\n'
|
|
|
|
|
s += '<p>' + getDescription(param.name, descriptions) + '</p>\n'
|
|
|
|
|
s += '<h2>Outputs</h2>\n'
|
|
|
|
|
for out in alg.outputs:
|
|
|
|
|
s += '<h3>' + out.description + '</h3>\n'
|
|
|
|
|
s += '<p>' + getDescription(out.name, descriptions) + '</p>\n'
|
|
|
|
|
s += '<br>'
|
|
|
|
|
s += '<p align="right">Algorithm author: ' + getDescription(ALG_CREATOR, descriptions) + '</p>'
|
|
|
|
|
s += '<p align="right">Help author: ' + getDescription(ALG_HELP_CREATOR, descriptions) + '</p>'
|
|
|
|
|
s += '</body></html>'
|
|
|
|
|
return s
|
2012-09-15 18:25:25 +03:00
|
|
|
|
2014-04-19 00:48:56 +02:00
|
|
|
def getDescription(name, descriptions):
|
|
|
|
|
if name in descriptions:
|
|
|
|
|
return descriptions[name].replace("\n", "<br>")
|
|
|
|
|
else:
|
|
|
|
|
return ''
|
