<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<br>
<br>
<div class="moz-cite-prefix">On 06/08/2015 14:42, Harshal Patil
wrote:<br>
</div>
<blockquote
cite="mid:201508061743.t76HhMC2026755@d28av06.in.ibm.com"
type="cite">
<div class="socmaildefaultfont" dir="ltr"
style="font-family:Arial;font-size:10.5pt">
<div dir="ltr">If you are looking at wok just as a web framework
which developers can use to write plugins for, then it doesn't
need to have any user facing webpage at all. Developers would
need to interact with wok's API anyway. </div>
<div dir="ltr"> </div>
<div dir="ltr">Now you can always create a marketplace for the
wok plugins where users can download and install plugins on
them on the fly and that could be the only page wok can serve
on it's own without any plugins. ;-) <br>
</div>
</div>
</blockquote>
<br>
Yeap!! I have thought about it too.<br>
<br>
My idea (for future, of course) is adding to wok a "Configuration
tab" so user can configure wok settings through UI.<br>
For example, which authentication method to use, which plugins to
install/uninstall/enable/disable, authorization settings and any
other setting related to the web sever config.<br>
<br>
It is the same approach we have on Jenkins.<br>
<br>
<blockquote
cite="mid:201508061743.t76HhMC2026755@d28av06.in.ibm.com"
type="cite">
<div class="socmaildefaultfont" dir="ltr"
style="font-family:Arial;font-size:10.5pt">
<div dir="ltr"> </div>
<div dir="ltr">But if that's not on the table then wok could
only display basic API usage for its plugin developers
on default index page, probably a button to load bare minimum
sample plugin as a proof of concept. </div>
<div dir="ltr"> </div>
<div dir="ltr"> </div>
</div>
</blockquote>
<br>
Yeap! I think we should go on that way by now and on future we can
implement the "Configuration tab" for wok.<br>
<br>
Sounds a good plan for you?<br>
<br>
<blockquote
cite="mid:201508061743.t76HhMC2026755@d28av06.in.ibm.com"
type="cite">
<div class="socmaildefaultfont" dir="ltr"
style="font-family:Arial;font-size:10.5pt">
<div dir="ltr"> </div>
<blockquote data-history-content-modified="1" dir="ltr"
style="border-left:solid #aaaaaa 2px; margin-left:5px;
padding-left:5px; direction:ltr">----- Original message -----<br>
From: Aline Manera <a class="moz-txt-link-rfc2396E" href="mailto:alinefm@linux.vnet.ibm.com"><alinefm@linux.vnet.ibm.com></a><br>
Sent by: <a class="moz-txt-link-abbreviated" href="mailto:kimchi-devel-bounces@ovirt.org">kimchi-devel-bounces@ovirt.org</a><br>
To: <a class="moz-txt-link-abbreviated" href="mailto:sureshab@linux.vnet.ibm.com">sureshab@linux.vnet.ibm.com</a>, <a class="moz-txt-link-abbreviated" href="mailto:kimchi-devel@ovirt.org">kimchi-devel@ovirt.org</a><br>
Cc:<br>
Subject: Re: [Kimchi-devel] [PATCH 1/1] Enabling help page for
wok base. This commit supports en_US only.<br>
Date: Thu, Aug 6, 2015 8:02 PM<br>
<div><font size="2" face="Default Monospace,Courier
New,Courier,monospace">I don't think we need a help page
for Wok framework.<br>
<br>
We have a lot to discuss on that, but the initial idea was
to load a<br>
simple page when running wok without any plugin.<br>
That page would describe the wok proposal - as a web
server framework<br>
based on plugins.<br>
<br>
I think it is hard to us to point the user to any specific
plugin like<br>
kimchi or ginger, as anyone can develop a wok plugin and
host anywhere.<br>
<br>
I am more for a generic simple page and no help.<br>
<br>
More (and different) thoughts on it are more than welcome.
=)<br>
<br>
On 04/08/2015 10:04, <a class="moz-txt-link-abbreviated" href="mailto:sureshab@linux.vnet.ibm.com">sureshab@linux.vnet.ibm.com</a> wrote:<br>
> From: Suresh Babu Angadi
<a class="moz-txt-link-rfc2396E" href="mailto:sureshab@linux.vnet.ibm.com"><sureshab@linux.vnet.ibm.com></a><br>
><br>
> Signed-off-by: Suresh Babu Angadi
<a class="moz-txt-link-rfc2396E" href="mailto:sureshab@linux.vnet.ibm.com"><sureshab@linux.vnet.ibm.com></a><br>
> ---<br>
> configure.ac | 2 +<br>
> src/wok/config.py.in | 5 +<br>
> ui/js/src/wok.main.js | 9 +-<br>
> ui/pages/Makefile.am | 2 +-<br>
> ui/pages/help/Makefile.am | 34 +++++++<br>
> ui/pages/help/dita-help.xsl | 26 +++++<br>
> ui/pages/help/en_US/Makefile.am | 23 +++++<br>
> ui/pages/help/en_US/wokhelp.dita | 27 +++++<br>
> ui/pages/help/wok.css | 208
+++++++++++++++++++++++++++++++++++++++<br>
> 9 files changed, 333 insertions(+), 3 deletions(-)<br>
> create mode 100644 ui/pages/help/Makefile.am<br>
> create mode 100644 ui/pages/help/dita-help.xsl<br>
> create mode 100644 ui/pages/help/en_US/Makefile.am<br>
> create mode 100644 ui/pages/help/en_US/wokhelp.dita<br>
> create mode 100644 ui/pages/help/wok.css<br>
><br>
> diff --git a/configure.ac b/configure.ac<br>
> index 47c2e6c..ee4d793 100644<br>
> --- a/configure.ac<br>
> +++ b/configure.ac<br>
> @@ -115,6 +115,8 @@ AC_CONFIG_FILES([<br>
> ui/libs/themes/base/Makefile<br>
> ui/libs/themes/base/images/Makefile<br>
> ui/pages/Makefile<br>
> + ui/pages/help/Makefile<br>
> + ui/pages/help/en_US/Makefile<br>
> ui/pages/websockify/Makefile<br>
> contrib/Makefile<br>
> contrib/DEBIAN/Makefile<br>
> diff --git a/src/wok/config.py.in
b/src/wok/config.py.in<br>
> index 5ffa936..c158a75 100644<br>
> --- a/src/wok/config.py.in<br>
> +++ b/src/wok/config.py.in<br>
> @@ -142,6 +142,11 @@ class WokConfig(dict):<br>
> '/wok-ui.html': {<br>
> 'tools.wokauth.on': True<br>
> },<br>
> + '/help': {<br>
> + 'tools.staticdir.on': True,<br>
> + 'tools.staticdir.dir':
'%s/ui/pages/help' % paths.prefix,<br>
> + 'tools.nocache.on': True<br>
> + }<br>
> }<br>
><br>
> def __init__(self):<br>
> diff --git a/ui/js/src/wok.main.js
b/ui/js/src/wok.main.js<br>
> index f4c9940..3dd76b8 100644<br>
> --- a/ui/js/src/wok.main.js<br>
> +++ b/ui/js/src/wok.main.js<br>
> @@ -349,7 +349,12 @@ wok.checkHelpFile =
function(path) {<br>
><br>
> wok.openHelp = function(e) {<br>
> var tab = $('#nav-menu a.current');<br>
> - var url =
$(tab).parent().find("input[name='helpPath']").val();<br>
> - window.open(url, "Wok Help");<br>
> + if (tab.length == 0 ){<br>
> + window.open("help/en_US/wokhelp.html","Wok
Help")<br>
> + }<br>
> + else {<br>
> + var url =
$(tab).parent().find("input[name='helpPath']").val();<br>
> + window.open(url, "Wok Help");<br>
> + }<br>
> e.preventDefault();<br>
> };<br>
> diff --git a/ui/pages/Makefile.am
b/ui/pages/Makefile.am<br>
> index 68f4c92..b3f5c2e 100644<br>
> --- a/ui/pages/Makefile.am<br>
> +++ b/ui/pages/Makefile.am<br>
> @@ -15,7 +15,7 @@<br>
> # See the License for the specific language
governing permissions and<br>
> # limitations under the License.<br>
><br>
> -SUBDIRS = websockify<br>
> +SUBDIRS = websockify help<br>
><br>
> htmldir = $(datadir)/wok/ui/pages<br>
><br>
> diff --git a/ui/pages/help/Makefile.am
b/ui/pages/help/Makefile.am<br>
> new file mode 100644<br>
> index 0000000..0dc8d9f<br>
> --- /dev/null<br>
> +++ b/ui/pages/help/Makefile.am<br>
> @@ -0,0 +1,34 @@<br>
> +# Copyright IBM Corp, 2014<br>
> +#<br>
> +# This library is free software; you can
redistribute it and/or<br>
> +# modify it under the terms of the GNU Lesser
General Public<br>
> +# License as published by the Free Software
Foundation; either<br>
> +# version 2.1 of the License, or (at your option)
any later version.<br>
> +#<br>
> +# This library is distributed in the hope that it
will be useful,<br>
> +# but WITHOUT ANY WARRANTY; without even the implied
warranty of<br>
> +# MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU<br>
> +# Lesser General Public License for more details.<br>
> +#<br>
> +# You should have received a copy of the GNU Lesser
General Public<br>
> +# License along with this library; if not, write to
the Free Software<br>
> +# Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301 USA<br>
> +<br>
> +SUBDIRS = en_US<br>
> +<br>
> +DITA_HTML_FILES = $(patsubst
%.dita,%.html,$(wildcard */*.dita))<br>
> +HTML_FILES = $(if $(DITA_HTML_FILES),
$(DITA_HTML_FILES), $(wildcard */*.html))<br>
> +DITA_XSL_FILE = dita-help.xsl<br>
> +<br>
> +EXTRA_DIST = $(DITA_XSL_FILE)<br>
> +<br>
> +helpdir = $(datadir)/wok/ui/pages/help<br>
> +<br>
> +dist_help_DATA = wok.css<br>
> +<br>
> +all: $(HTML_FILES) $(wildcard */*.dita)<br>
> +<br>
> +%.html: %.dita $(DITA_XSL_FILE)<br>
> + xsltproc -o $@ $(DITA_XSL_FILE) $<<br>
> +<br>
> +CLEANFILES = $(HTML_FILES)<br>
> \ No newline at end of file<br>
> diff --git a/ui/pages/help/dita-help.xsl
b/ui/pages/help/dita-help.xsl<br>
> new file mode 100644<br>
> index 0000000..fb49855<br>
> --- /dev/null<br>
> +++ b/ui/pages/help/dita-help.xsl<br>
> @@ -0,0 +1,26 @@<br>
> +<?xml version="1.0" encoding="UTF-8"?><br>
> +<xsl:stylesheet version="1.0"<br>
> +
xmlns:xsl=<a class="moz-txt-link-rfc2396E" href="http://www.w3.org/1999/XSL/Transform">"http://www.w3.org/1999/XSL/Transform"</a><br>
> + xmlns=<a class="moz-txt-link-rfc2396E" href="http://www.w3.org/1999/xhtml">"http://www.w3.org/1999/xhtml"</a>><br>
> + <xsl:output method="xml" indent="yes"
encoding="UTF-8" /><br>
> +<br>
> + <xsl:template match="/"><br>
> + <html><br>
> + <head><br>
> + <title><xsl:value-of
select="/cshelp/title" /></title><br>
> + <meta charset="UTF-8" /><br>
> + <link rel="shortcut icon"
href=<a class="moz-txt-link-rfc2396E" href="https://mail.notes.na.collabserv.com/livemail/0/../images/logo.ico">"https://mail.notes.na.collabserv.com/livemail/0/../images/logo.ico"</a>
/><br>
> + <link rel="stylesheet"
type="text/css"
href=<a class="moz-txt-link-rfc2396E" href="https://mail.notes.na.collabserv.com/livemail/0/wok.css">"https://mail.notes.na.collabserv.com/livemail/0/wok.css"</a>
/><br>
> + </head><br>
> + <body><br>
> + <xsl:apply-templates
select="//cshelp" /><br>
> + </body><br>
> + </html><br>
> + </xsl:template><br>
> +<br>
> + <xsl:template match="cshelp"><br>
> + <h1><xsl:value-of select="title"
/></h1><br>
> + <p class="shortdesc"><xsl:value-of
select="shortdesc" /></p><br>
> + <p class="csbody"><xsl:copy-of
select="csbody/node()" /></p><br>
> + </xsl:template><br>
> +</xsl:stylesheet><br>
> diff --git a/ui/pages/help/en_US/Makefile.am
b/ui/pages/help/en_US/Makefile.am<br>
> new file mode 100644<br>
> index 0000000..b1e807d<br>
> --- /dev/null<br>
> +++ b/ui/pages/help/en_US/Makefile.am<br>
> @@ -0,0 +1,23 @@<br>
> +# Copyright IBM Corp, 2014<br>
> +#<br>
> +# This library is free software; you can
redistribute it and/or<br>
> +# modify it under the terms of the GNU Lesser
General Public<br>
> +# License as published by the Free Software
Foundation; either<br>
> +# version 2.1 of the License, or (at your option)
any later version.<br>
> +#<br>
> +# This library is distributed in the hope that it
will be useful,<br>
> +# but WITHOUT ANY WARRANTY; without even the implied
warranty of<br>
> +# MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU<br>
> +# Lesser General Public License for more details.<br>
> +#<br>
> +# You should have received a copy of the GNU Lesser
General Public<br>
> +# License along with this library; if not, write to
the Free Software<br>
> +# Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301 USA<br>
> +<br>
> +en_US_helpdir = $(datadir)/wok/ui/pages/help/en_US<br>
> +<br>
> +dist_en_US_help_DATA = $(wildcard *.html) $(NULL)<br>
> +<br>
> +EXTRA_DIST = $(wildcard *.dita)<br>
> +<br>
> +CLEANFILES = $(wildcard *.html)<br>
> \ No newline at end of file<br>
> diff --git a/ui/pages/help/en_US/wokhelp.dita
b/ui/pages/help/en_US/wokhelp.dita<br>
> new file mode 100644<br>
> index 0000000..582e47b<br>
> --- /dev/null<br>
> +++ b/ui/pages/help/en_US/wokhelp.dita<br>
> @@ -0,0 +1,27 @@<br>
> +<?xml version="1.0" encoding="UTF-8"?><br>
> +<!--Arbortext, Inc., 1988-2011, v.4002--><br>
> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA
CSHelp//EN"<br>
> + "..\dtd\cshelp.dtd"><br>
> +<?Pub Sty _display FontColor="red"?><br>
> +<?Pub Inc?><br>
> +<!--This DITA specialized document type is not
supported by the Authoring Tools development team.<br>
> +For support please see:<br>
>
+https://w3.opensource.ibm.com/projects/dita-cshelp/--><br>
> +<cshelp id="wokbase" xml:lang="en-us"><br>
> +<title>Wok (Webserver Originated from
Kimchi)</title><br>
> +<shortdesc>Wok is a cherrypy-based web
framework with HTML5 support that is extended by plugins
which expose functionality through REST
APIs.</shortdesc><br>
> +<csbody><br>
> +<p>Currently available plugins are Kimchi
(Virtualization Management) and Ginger (System
Administration).<br>
> +Wok comes with a sample plugin for education
purposes.<ul><br>
> +<li><uicontrol>Download Kimchi :
</uicontrol><br>
> +<a
href=<a class="moz-txt-link-rfc2396E" href="https://github.com/kimchi-project/kimchi/tree/wok">"https://github.com/kimchi-project/kimchi/tree/wok"</a><br>
> +target="_blank"
><a class="moz-txt-link-freetext" href="https://github.com/kimchi-project/kimchi/tree/wok">https://github.com/kimchi-project/kimchi/tree/wok</a></a><br>
> +</li><br>
> +<li><uicontrol>Download Ginger :
</uicontrol><br>
> +<a
href=<a class="moz-txt-link-rfc2396E" href="https://github.com/kimchi-project/ginger/tree/ginger_wok">"https://github.com/kimchi-project/ginger/tree/ginger_wok"</a><br>
> +target="_blank"
><a class="moz-txt-link-freetext" href="https://github.com/kimchi-project/ginger/tree/ginger_wok">https://github.com/kimchi-project/ginger/tree/ginger_wok</a></a><br>
> +</li><br>
> +</ul><br>
> +</p><br>
> +</csbody><br>
> +</cshelp><br>
> diff --git a/ui/pages/help/wok.css
b/ui/pages/help/wok.css<br>
> new file mode 100644<br>
> index 0000000..32fae4a<br>
> --- /dev/null<br>
> +++ b/ui/pages/help/wok.css<br>
> @@ -0,0 +1,208 @@<br>
> +/*<br>
> + * Project Kimchi<br>
> + *<br>
> + * Copyright IBM, Corp. 2014<br>
> + *<br>
> + * Licensed under the Apache License, Version 2.0
(the "License");<br>
> + * you may not use this file except in compliance
with the License.<br>
> + * You may obtain a copy of the License at<br>
> + *<br>
> + * <a moz-do-not-send="true"
href="http://www.apache.org/licenses/LICENSE-2.0"
target="_blank">http://www.apache.org/licenses/LICENSE-2.0</a><br>
> + *<br>
> + * Unless required by applicable law or agreed to in
writing, software<br>
> + * distributed under the License is distributed on
an "AS IS" BASIS,<br>
> + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied.<br>
> + * See the License for the specific language
governing permissions and<br>
> + * limitations under the License.<br>
> + */<br>
> +BODY {<br>
> + background: #FFFFFF;<br>
> + margin-bottom: 1em;<br>
> + margin-left: .5em;<br>
> +}<br>
> +<br>
> +bold {<br>
> + font-weight: bold;<br>
> +}<br>
> +<br>
> +boldItalic {<br>
> + font-weight: bold;<br>
> + font-style: italic;<br>
> +}<br>
> +<br>
> +italic {<br>
> + font-style: italic;<br>
> +}<br>
> +<br>
> +underlined {<br>
> + text-decoration: underline;<br>
> +}<br>
> +<br>
> +uicontrol {<br>
> + font-weight: bold;<br>
> +}<br>
> +<br>
> +filepath {<br>
> + font-family: monospace, monospace;<br>
> +}.option {<br>
> + font-family: monospace, monospace;<br>
> +}<br>
> +<br>
> +cmdname {<br>
> + font-weight: bold;<br>
> + font-family: monospace, monospace;<br>
> +}<br>
> +<br>
> +.defparmname {<br>
> + font-weight: bold;<br>
> + text-decoration: underline;<br>
> + font-family: monospace, monospace;<br>
> +}<br>
> +<br>
> +.kwd {<br>
> + font-weight: bold;<br>
> +}<br>
> +<br>
> +.defkwd {<br>
> + font-weight: bold;<br>
> + text-decoration: underline;<br>
> +}<br>
> +<br>
> +var {<br>
> + font-style : italic;<br>
> +}<br>
> +<br>
> +strongwintitle {<br>
> + font-weight : bold;<br>
> +}<br>
> +<br>
> +parmname {<br>
> + font-weight: bold;<br>
> + font-family: monospace, monospace;<br>
> + white-space: nowrap;<br>
> +}<br>
> +<br>
> +code {<br>
> + font-family: monospace, monospace;<br>
> +}<br>
> +<br>
> +pre {<br>
> + font-family: monospace, monospace;<br>
> +}<br>
> +<br>
> +CITE {<br>
> + font-style: italic;<br>
> +}<br>
> +<br>
> +EM {<br>
> + font-style: italic;<br>
> +}<br>
> +<br>
> +STRONG {<br>
> + font-weight: bold;<br>
> +}<br>
> +<br>
> +VAR {<br>
> + font-style: italic;<br>
> +}<br>
> +<br>
> +dt {<br>
> + font-weight: bold;<br>
> +}<br>
> +<br>
>
+/***********************************************************<br>
> + * Basic fonts<br>
> +
***********************************************************/<br>
> +body,<br>
> +td,<br>
> +th,<br>
> +caption {<br>
> + font-family: Verdana, Arial, Helvetica,
sans-serif;<br>
> + font-size: 10pt;<br>
> +}<br>
> +<br>
> +pre, code {<br>
> + font-family: MS Courier New, Courier, monospace;<br>
> +}<br>
> +<br>
> +h1, h2, h3 {<br>
> + font-size: 12pt;<br>
> + font-weight: bold;<br>
> + color: #336699;<br>
> +}<br>
> +<br>
> +h4 {<br>
> + font-size: 10pt;<br>
> + font-weight: bold;<br>
> + color: #336699;<br>
> +}<br>
> +<br>
>
+/***********************************************************<br>
> + * Basic indents, padding, and margin<br>
> +
***********************************************************/<br>
> +body {<br>
> + color: black;<br>
> + background-color: white;<br>
> + margin: 0;<br>
> + padding-top: 0.2em;<br>
> + padding-left: 0.6em;<br>
> + padding-right: 0.2em;<br>
> + padding-bottom: 1em;<br>
> +}<br>
> +<br>
> +h1,<br>
> +h2,<br>
> +h3,<br>
> +h4,<br>
> +h5,<br>
> +h6 {<br>
> + padding: 0;<br>
> + margin-top: 1em;<br>
> + margin-bottom: 0.75em;<br>
> + margin-left: 0;<br>
> + margin-right: 0;<br>
> +}<br>
> +<br>
> +address,<br>
> +dl,<br>
> +li,<br>
> +p {<br>
> + padding: 0;<br>
> + margin-top: 0.75em;<br>
> + margin-bottom: 0.75em;<br>
> + margin-left: 0;<br>
> + margin-right: 0;<br>
> + line-height: 125%;<br>
> +}<br>
> +<br>
> +td dl {<br>
> + margin-left: 2em;<br>
> +}<br>
> +<br>
> +pre {<br>
> + padding: 0;<br>
> + margin-top: 0.75em;<br>
> + margin-bottom: 0.75em;<br>
> + margin-left: 2em;<br>
> + margin-right: 0;<br>
> +}<br>
> +<br>
> +ol,<br>
> +ul {<br>
> + padding: 0;<br>
> + margin-top: 0.75em;<br>
> + margin-bottom: 0.75em;<br>
> + margin-left: 2.00em;<br>
> + margin-right: 0;<br>
> +}<br>
> +<br>
> +dd {<br>
> + margin-left: 3.00em;<br>
> + margin-top: 0.75em;<br>
> + margin-bottom: 0.75em;<br>
> +}<br>
> +<br>
> +dt {<br>
> + margin-left: 1.00em;<br>
> + margin-top: 0.75em;<br>
> +}<br>
<br>
_______________________________________________<br>
Kimchi-devel mailing list<br>
<a class="moz-txt-link-abbreviated" href="mailto:Kimchi-devel@ovirt.org">Kimchi-devel@ovirt.org</a><br>
<a moz-do-not-send="true"
href="http://lists.ovirt.org/mailman/listinfo/kimchi-devel"
target="_blank">http://lists.ovirt.org/mailman/listinfo/kimchi-devel</a></font><br>
</div>
</blockquote>
<div dir="ltr"> </div>
</div>
<br>
</blockquote>
<br>
</body>
</html>