PoNG Static HTML Distribution - Versionsgeschichte

Mh: /* PoNG Quick Start: */

2015-02-24T18:56:30Z

‎PoNG Quick Start:

Mh: /* What is inside the install package */

2015-02-24T18:55:40Z

‎What is inside the install package

Mh: /* PoNG License */

2015-02-22T18:16:47Z

‎PoNG License

Mh: /* PoNG Quick Start: */

2015-02-22T07:50:32Z

‎PoNG Quick Start:

Mh am 22. Februar 2015 um 07:46 Uhr

2015-02-22T07:46:45Z

Mh: /* PoNG Quick Start: */

2015-02-19T07:17:46Z

‎PoNG Quick Start:

Mh: Die Seite wurde neu angelegt: „Static does not mean, the PoNG portal is not dynamic -- it just needs only a static backend!! So no need of PHP or Tomcat or JEE servers ... Please also c…“

2015-02-17T17:38:00Z

Die Seite wurde neu angelegt: „Static does not mean, the PoNG portal is not dynamic -- it just needs only a static backend!! So no need of PHP or Tomcat or JEE servers ... Please also c…“

Neue Seite

Static does not mean, the [[PoNG]] portal is not dynamic -- it just needs only a static backend!! So no need of PHP or Tomcat or JEE servers ...

Please also check the [[PoNG Release Notes]].

== [[PoNG]] Quick Start: ==
# Download the static html package [http://keller.minidns.net/mh/pong_v0.3a1.zip here] (527 kB)
# Unpack the archive into your web server html directory, e.g. <code>/var/www/portal</code>
# Start the web browser and point it to the portal root, e.g. <code>http://mydomain.com/portal</code>

The portal contains two pages, one static welcome page and a second form type page.

Please read the [[PoNG|abstract]] to understand [[PoNG Description|the idea and vision]].

[[Category:PoNG]]

== What is inside the install package ==
{|
| . || index.html || an empty page, just to initialize the framework -- there is no need to edit this file
|-
| . || nav || [[PoNG_Structure_Specification#JSON_basics|JSON]] to define the navigation bar's items
|-
| /i18n/ || || translation packages, add your translations here
|-
| /i18n/ || DE.json
|-
| /i18n/ || EN.json
|-
| /css/ || || style sheets to customize the look and feel
|-
| /css/ || custom.css || define your modifications here
|-
| /css/ || ... || other files, you won't need to customize any of them
|-
| /img/ || ... || folder for graphic decoration and pictures
|-
| /js/ || || The heart of the framework
|-
| /js/ || portal-ng-XY.js || (main framework
|-
| /js/ || portal-ng-modules.js || (modules hook list
|-
| /js/ || /pong-modules || ... folder with some ready to use plug ins ...
|-
|-
| /svc/ || || your services, should deliver [[PoNG_Structure_Specification#JSON_basics|JSON]] data, HTML and JS content
|-
| /svc/layout/ || || serve [[PoNG_Structure_Specification|JSON config]] for portal pages
|-
| /svc/layout/main/ || structure || [[PoNG_Structure_Specification#JSON_basics|JSON]] to define start page and main layout, other layouts may include the header and footer from here
|-
| /svc/layout/test/ || structure || JSON for a layout with two rows, with a form in the 1st row and two columns for output in the second row
|-
| /svc/test/ || || This is a REST service
|-
| /svc/test/ || pong-form || [[PoNG_Structure_Specification#JSON_basics|JSON]] to initialize the [[PoNG Module: Form View|web form]] and the actions)
|-
| /svc/test/info/ || (index.html) || delivers dummy output for the "info" button
|-
| /svc/test/check/ || (index.html) || delivers dummy output for the "check" button
|-
| /svc/test/help/ || (index.html) || PHP -ui- to deliver help text in different languages
|}

== Start customizing the static portal ==
'''Step 1:'''

Customize the [[PoNG Module: Navigation Bar|nav bar]] by editing the <code>nav</code> file.

If you add an item, e.g. "blah", you have to add a layout file, so <code>/svc/layout/blah/structure</code>, refer "step 2"

'''Step 2:'''

Customize the [[PoNG_Structure_Specification|layout specification]]:
* Customize the [[PoNG_Structure_Specification#Header|header]] and [[PoNG_Structure_Specification#Footer|footer]] as you like. I think you may want to replace the logo.
* Edit the [[PoNG_Structure_Specification|structure file]] and define your own set of rows and columns and point them to [[PoNG_Structure_Specification#Resources|resources]] and [[PoNG Modules|define module]] types. Now you have to configure the resources and modules, refer "step 3".

'''Step 3:'''

The resources are "folders" in the static backend, so you have to create the folders with the resource names (specified in "step 2") and put the module config there to tell the [[PoNG Modules|module plug-ins]], how to deal with the content of the resource.

== Shared scipts and CSSs ==
To share the JS scripts for modules and CSS files you can modify the main <code>index.html</code> file. By default a relative path to subdirectories is used.

To change the loaders, please search and modify the following section in the <code>index.html</code>:
// EDIT THIS VAR TO SHARE THE INSTALL PACKAGES
var cssPath = "css/";
var jsPath = "js/";
var modulesJsPath = "js/pong-modules/";
var modulesCssPath = "css/pong-modules/";

@@ Zeile 4: / Zeile 4: @@
 == [[PoNG]] Quick Start: ==
-The ''PoNG JS Framework V0.3'' and the ''PoNG Static HTML Distribution V0.3'' are released under [[PoNG_Static_HTML_Distribution#PoNG_License|MIT License]]
+The ''PoNG JS Framework V0.4'' and the ''PoNG Static HTML Distribution V0.4'' are released under [[PoNG_Static_HTML_Distribution#PoNG_License|MIT License]]
-# Download the static html package [http://mh-svr.de/downloads/pong_0.3.zip here (V0.3, 620 kB)]
+# Download the static html package [http://mh-svr.de/downloads/pong_v0.4.zip here (V0.3, 625 kB)]
 # Unpack the archive into your web server html directory, e.g. <code>/var/www/portal</code>
 # Start the web browser and point it to the portal root, e.g. <code>http://mydomain.com/portal</code>

← Nächstältere Version		Version vom 22. Februar 2015, 18:16 Uhr
Zeile 91:		Zeile 91:


−	== PoNG License ==	+	== PoNG JS Framework License ==
	The MIT License (MIT)		The MIT License (MIT)

← Nächstältere Version		Version vom 22. Februar 2015, 07:46 Uhr
Zeile 88:		Zeile 88:
	var modulesJsPath = "js/pong-modules/";		var modulesJsPath = "js/pong-modules/";
	var modulesCssPath = "css/pong-modules/";		var modulesCssPath = "css/pong-modules/";
		+
		+
		+	== PoNG License ==
		+	The MIT License (MIT)
		+
		+	Copyright (c) 2014 Markus Harms, ma@mh-svr.de
		+
		+	Permission is hereby granted, free of charge, to any person obtaining a copy
		+	of this software and associated documentation files (the "Software"), to deal
		+	in the Software without restriction, including without limitation the rights
		+	to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
		+	copies of the Software, and to permit persons to whom the Software is
		+	furnished to do so, subject to the following conditions:
		+
		+	The above copyright notice and this permission notice shall be included in
		+	all copies or substantial portions of the Software.
		+
		+	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
		+	IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
		+	FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
		+	AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
		+	LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
		+	OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
		+	THE SOFTWARE.

@@ Zeile 39: / Zeile 39: @@
 | /js/ ||    portal-ng-XY.js     ||    (main framework
 |-
-| /js/ ||    portal-ng-modules.js  ||  (modules hook list
+| /pong-modules  ||    portal-ng-modules.js  ||  (modules hook list
 |-
-| /js/ ||    /pong-modules      ||     ... folder with some ready to use plug ins ...
+| /pong-modules  || XYZ/        ||     ... sub folder with plug ins ...
 |-
 |-