airavata-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ndo...@apache.org
Subject airavata-php-gateway git commit: Documentation for Theming added.
Date Tue, 24 Jan 2017 22:01:30 GMT
Repository: airavata-php-gateway
Updated Branches:
  refs/heads/develop b0b5152e5 -> 998ac3816


Documentation for Theming added.


Project: http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/repo
Commit: http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/commit/998ac381
Tree: http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/tree/998ac381
Diff: http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/diff/998ac381

Branch: refs/heads/develop
Commit: 998ac3816211f3eb485d3f4071c7383cb85746b5
Parents: b0b5152
Author: Nipurn Doshi <nipunhere@gmail.com>
Authored: Tue Jan 24 13:52:03 2017 -0800
Committer: Nipurn Doshi <nipunhere@gmail.com>
Committed: Tue Jan 24 13:52:03 2017 -0800

----------------------------------------------------------------------
 public/themes/README                         | 115 ++++++++++++++++++++++
 public/themes/base/partials/header.blade.php |   0
 public/themes/base/partials/header.php       |   0
 3 files changed, 115 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/blob/998ac381/public/themes/README
----------------------------------------------------------------------
diff --git a/public/themes/README b/public/themes/README
new file mode 100644
index 0000000..f803f76
--- /dev/null
+++ b/public/themes/README
@@ -0,0 +1,115 @@
+Theme Documentation ( Read before starting to work on your themes)
+------------
+
+Steps to create your own theme:
+
+1) First thing first, PGA themes use Bootstrap 3.x and Blade as its templating engine as
a base for all UI Development. The capability to let users use another UI framework is being
worked upon and would be available in the future. If users still want to use another UI framework,
they could add it in theme header/footer and it will act as the overwriting entity on anything
which Bootstrap has a hold on.
+
+2) Copy <pga-root-folder>/public/themes/base folder in the same 'themes' folder and
rename it to your theme. Lets call this folder 'theme1' for the rest of the steps.
+
+3) PGA Theme structure:
+
+Below is how all UIs are layered in a theme. 
+
+ ----------------------------------
+| THEME HEADER                     |
+ ----------------------------------
+| PGA HEADER                       |
+ ----------------------------------
+| PGA BODY (main content)          |
+ ----------------------------------
+| PGA FOOTER                       |
+ ----------------------------------
+| THEME FOOTER                     |
+ ----------------------------------
+
+Folder 'Theme1' contains 4 folders:
+
+- Assets:             All styling, scripts and image files can be kept here and accessed
in theme pages using- 
+{{ URL::to('/') }}/themes/{{Session::get('theme')}}/assets/<filename.css>
+Users can create additional folders inside 'assets' for structuring purposes like css, js,
img files.
+- Partials:           All HTML blocks and pages which should be included in a theme can be
added here. By default, this folder contains header.blade.php, footer.blade.php and template.blade.php
and should NOT be deleted.
+- Layouts and Views:  Additional folders to structure extra theme components and plugin layouts
if any.
+
+
+
+THEME HEADER:
+------------
+This is the space where Theme creaters can add their theme headers which would
+generally contain styles or links to styles, global navigation for a Scientific gateway having
logo/s, links etc which would show across all pages on PGA.
+
+All content for Theme Header can be added in theme1/partials/header.blade.php.
+
+Additional pages other than the landing page can be created and linked to THEME header. The
way to do that is add the page content to 'theme1/partials/<page1.blade.php>' and can
be referenced/linked from anywhere inside the theme pages with the link: '{{URL::to('/')}}/pages/page1'
( blade.php does not need to be written).
+
+Sample Theme Header content: 
+-----------------------------------
+<title>Theme1</title>
+
+<link href='http://fonts.googleapis.com/css?family=Lato:100,300,400,700,900,100italic,300italic,400italic,700italic,900italic'
rel='stylesheet' type='text/css'>
+<link href='http://fonts.googleapis.com/css?family=Arvo:400,700' rel='stylesheet' type='text/css'>
+
+<link media="all" type="text/css" rel="stylesheet" href="{{ URL::to('/') }}/themes/{{Session::get('theme')}}/assets/css/style.css"/>
+
+<div class="container-fluid">
+    <nav class="nav navbar-default navbar-inverse">
+        <!-- Brand and toggle get grouped for better mobile display -->
+    <!--    <div class="navbar-header page-scroll" id="home">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand page-scroll" href="{{ URL::to('/') }}/home">
+                THEME 1
+            </a>
+        </div>
+
+        <!-- Collect the nav links, forms, and other content for toggling -->
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <li>
+                    <a href="{{URL::to('/')}}/pages/documentation">Documentation</a>
+                </li>
+                <li>
+                    <a href="{{URL::to('/')}}/pages/publications">Publications</a>
+                </li>
+                <li>
+                    <a href="{{URL::to('/')}}/pages/about">About</a>
+                </li>
+                <li>
+                    <a href="{{URL::to('/')}}/pages/contact">Contact</a>
+                </li>
+            </ul>
+        </div>
+        <!-- /.navbar-collapse -->
+<!--</nav>
+</div>
+-----------------------------------
+
+PGA HEADER and PGA FOOTER:
+------------
+All layout files which help PGA dashboard to run smoothly exist in this layer and should
NOT be changed. Any changes done to these files will get removed on updating PGA. 
+
+PGA header contains a default navbar which helps to navigate throughout user dashboard. A
simple capability to remove this navbar before users log in, exists in pga_config.php where
they can set 'theme-based-login-links-configured' to true.
+Before setting this property to true, please ensure that Login and Register links are configured
somewhere in THEME HEADER.
+Login Link:     {{URL::to('/')}}/login
+Register Link:  {{URL::to('/')}}/register
+
+PGA footer mainly includes scripts needed in PGA.
+
+PGA BODY:
+------------
+Theme landing page content should be added to  theme1/partials/template.blade.php.
+
+Any other pages ( outside of PGA Dashboard) can also be created inside theme1/partials/<page1.blade.php>
and can be referenced/linked from anywhere inside the theme pages with the link: '{{URL::to('/')}}/pages/page1'
( blade.php does not need to be written). This helps to add global links to THEME HEADER like
About, Contact, Documentation etc.
+
+
+THEME FOOTER:
+------------
+Global theme footer can be added to THEME FOOTER layer. It is recommended that all script
files and/or their links are added in Theme footer instead of Header unless necessary.
+
+Since THEME FOOTER is the last layer, it helps to overwrite any scripts included before by
PGA HEADER/PGA FOOTER. 
+
+All content for Theme Footer can be added in theme1/partials/footer.blade.php.

http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/blob/998ac381/public/themes/base/partials/header.blade.php
----------------------------------------------------------------------
diff --git a/public/themes/base/partials/header.blade.php b/public/themes/base/partials/header.blade.php
new file mode 100644
index 0000000..e69de29

http://git-wip-us.apache.org/repos/asf/airavata-php-gateway/blob/998ac381/public/themes/base/partials/header.php
----------------------------------------------------------------------
diff --git a/public/themes/base/partials/header.php b/public/themes/base/partials/header.php
deleted file mode 100644
index e69de29..0000000


Mime
View raw message