Default Website Development: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
 
(61 intermediate revisions by the same user not shown)
Line 1: Line 1:
==The default CMX website Development==
==The default CMX website Development==


These section of the Wiki will enable you to get the latest information and resources for the new default CMX website shipped with version 3.10.x
These section of the Wiki will enable you to get the latest information and resources for the alternative to the default CumulusMX public website.


===The current default site===
===Alternative public website===
As part of the development process of the CumulusMX Interface, I have generated a new public website (with template pages) as an alternative to the one provided with CumulusMX.
This will always be available to you in the 'websites' folder of your Cumulus MX Installation. If you wish to undo any of the changes that downloads from this page generate then simply re-copy the websites folder to your web host.


This template builds on the development of the AI and introduces a number of features and/or improvements.
===Templates===
There are currently 3 alternative template frameworks for the site. These all include 4 variations for the main content area of a page; a single column, two column, three column and four columns. These can be used as the framework for existing pages or to add your own content as required. You can choose to use them in any combination or just one - its up to you. All come with a pdf readme file to help you use them but for full information about the available styles visit [https://www.w3schools.com/w3css/default.asp w3Schools].


Full details of the alternative public website, including screenshots can be fond on [https://oaktreewebs.co.uk/wiki/ my wiki] together with comprehensive instructions on how to install, use and modify.
The available frameworks are:
* A lefthand sidebar with the main panel on the right. Download at [https://cumuluswiki.org/images/7/75/LeftSBTemplates.zip Left-handed sidebar template]. Updated: 24th June 2023
* A righthand sidebar with the man panel on the left. Download at [Https://cumuluswiki.org/images/6/67/RightSBTemplates.zip Right-handed sidebar templates]. This is similar to the default site but the sidebar starts higher up the screen. Updated 24th June 2023
* A set with no sidebar - just the main content area. Download at [Https://cumuluswiki.org/images/2/2a/NoSBTemplates.zip No sidebar templates]. The single column version gauges page is set wider than other pages. Updated: 24th June 2023


Its major change is that all configuration data is held in one place: the CMXConfig object, so you can set the location of your data, your NOAA reports and the menu just by editing one part of one file.
====Additional/Alternative Pages====
=====Gauges=====
We also have an alternative to the default gauges.htm page. This does away with the sidebar and places the gauges in fixed width panels that automatically reposition themselves as the page width is changed. The gauges are also able to be placed in any order without resorting to cut-n-paste. Just add/change a number to their order style and its done.


The menu has also been enhanced with some additional features while maintaining the single json structure of the original.
This can be downloaded from [Https://cumuluswiki.org/Downloads/NewGauges.zip Gauges Page]. Updated: 11 March 2021


This site also comes with new themes (unfortunately not compatible with the AI or previous versions) that should be easier to modify for your own needs.
=====NOAA Reports=====
This is now included in the standard default website. It enables any of your NOAA reports to be loaded into the page using Ajax calls so no page refresh is needed. Updated: 16 June 2021.


'''Download the [https://www.cumuluswiki.org/images/0/08/PublicWebsite.zip latest version here]''' (Updated: (12:34 3rd Apr 2025) '''W3C Validated code'''.) [This version accommodates HTML formatted NOAA reports and corrects the use of 'on' in all-time reports. Note that if you opt to use these formatted NOAA reports you will need to re-generate '''ALL''' existing reports '''and upload them'''.]
===Complete ready to run alternative website pack===
We now have a complete [[ResponsiveSite.zip | alternative 'website']] ready for use. It is very similar to the current supplied website but with the following changes:


'''You can view my site using the new default templates on [https://ai2weather.uk Oaktree Weather ].
* There are two (2) gauges pages - gauges.htm and gaugesII.htm. They are both full width. The first removes the radio buttons from all gauges making is easy to see all gauges without scrolling. The options are provided in a dropdown page menu along with units. The second shows individual gauges in panels with their radio buttons.
* There is also a 'today v yesterday' page (todayYest.htm), for those that want to be able to compare readings.
* The layout of the sidebar is slightly different - it starts at the top of the right hand panel.
The menu has NOT been included in the zip and consequently you will need to adjust it to use the chosen pages listed above.
The zip file does contain the three css stylesheets; colours.css, mx-templates.css and gauges.css which will need to be copied to the correct location on your waebserver.


====Amendments since last revision====
'''Please backup your site before uploading and extracting this alternative website'''
This is a full rebuild of the site.


===Colour Themes===
==Installing==
Download the current zip file to you local machine and upload it to your web server.
The website and templates use colour themes to make it easier to change the colour throughout the site. By downloading the colour theme pack, you can simply rename the chosen colour as 'colours.css' and it will be applied throughout your site. All colour themes have now been updated to use ''css variables'' for the available theme colours. This makes it much easier to add your theme colours to your custom pages, or style sheets. It is also possible to apply theme colours to the gauges tooltips in this way.
*Unzip it in the same location as your existing site - it will not overwrite the existing pages
*:The new site uses .html pages whereas the existing default site uses .htm
*; If you visit your site without specifying a page you will be taken to the new template pages,
*;Specifying a page such as index.htm will display your old template pages.


*: Please clear your browser cache before viewing.
For example, to add a coloured border to an element you can add the style like so:
<nowiki><span style="border-color: var(--d2);">**</span></nowiki> or <nowiki><span style="w3-theme-d2-bdr w3-border">**</span></nowiki>.


===Your Own Pages===
Visit the new '''[https://weather.oaktreewebs.co.uk/ATThemes.htm Theme Viewer]''' to preview any of these themes on a basic template page. You can download individual themes directly from that page. Alternatively you can download all themes (plus a 'readme.txt' file explaining the styles) [[File:ColourSchemes.zip | here]]
'''As with previous releases, the public website template also includes a template page'''.
.


The template.html page is provided to make it easier for you to add your own pages while retaining the look and feel of the website. The template page is called '''template.html'''.
Additional themes have now been added. The download includes a reworked default 'colours.css' stylesheet to also use css variables and a ReadMe file to explain the styles used.


<big>Editing</big>
The current list is:
The template page shows all the different column layouts that are available. These are:
{| class="wikitable"
ax-column1, ax-column2, ax-column3, ax-column4, ax-column5 and ax-column6
|-
! Theme !! Theme !! Theme !! Theme !! Theme !! Theme
|-
| AlmondBuff || AlmostMauve || Arcadia || BasicGrey || CherryTomato || ChiliOil
|-
| colours || CrocusPetal || CylonYellow || Emporador || GreyBlue (new) || GreyGreen (new)
|-
| GreyRed (new) || HarbourMist || Limelight || LimePunch || Marsala || MartiniOlive
|-
| MeerKat || NebulasBlue || QuietGrey || ReadPear || RussetOrange || SailorBlue
|-
| SargassoSea || SlateGrey || SpringCrocus || Tofu || Ultraviolet || ValiantPoppy
|-
| WarmSand || - || - || - || - || -
|}


: These will always try to display the indicated number of columns but as the screen becomes small will automatically collapse into fewer columns as appropriate.
Use this link [https://cumuluswiki.org/images/4/43/ColourSchemes.zip Additional colour schemes] to down load the schemes. Updated: 24th Jun 2023.
:; If there are more panels than columns they will gracefully split onto additional rows while retaining their column settings.
:; Rows with fewer panels than columns will either stretch the remaining panels across the full width or distribute them centrally - this can be controlled by you.


⚫
For full details visit [https://oaktreewebs.co.uk/wiki/ my wiki].
===An Alternate Default Website===
====Available 24th June 2023====
As an alternative to the supplied website, you can now download a reworked alternative [https://www.cumuluswiki.org/images/4/4c/DefaultWebSiteV3.zip DefaultWebSiteV3.zip] ]. (Updated 09:15 6th July 2023).


==Editing the website menu==
This update corrects some spellinglistakes, fixes the missing '@' symbol on th records pages and includes some additional themes.


Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full details of the menu and how to edit it.
Note the the 'page-manager.js' file is set to collect data from a sub-folder. To correct this change line 32 to the following:


==Changing the Theme and Other Settings==
<nowiki>let dataLocation="";</nowiki>


Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full information on configuring and setting up the alternative website.
This site includes some of the features made available in the AI mentioned below. It is even more responsive, has more consistent graphs and no sidebars. It is easy to add or remove additional panels and a template page is provided to enable you to add your own pages more easily. It includes normal and dark mode themes that can be configured by editing its 'page-manager.js' file.

⚫
To see it in action visit: https://weather.oaktreewebs.co.uk

===An Alternative Interface===
A new addition to the existing Interface site used for managing your weather station is now available. You can find out about it here: [[Alternative_Interface|Alternative Interface]].

Latest revision as of 11:34, 3 April 2025

The default CMX website Development

These section of the Wiki will enable you to get the latest information and resources for the alternative to the default CumulusMX public website.

Alternative public website

As part of the development process of the CumulusMX Interface, I have generated a new public website (with template pages) as an alternative to the one provided with CumulusMX.

This template builds on the development of the AI and introduces a number of features and/or improvements.

Full details of the alternative public website, including screenshots can be fond on my wiki together with comprehensive instructions on how to install, use and modify.

Its major change is that all configuration data is held in one place: the CMXConfig object, so you can set the location of your data, your NOAA reports and the menu just by editing one part of one file.

The menu has also been enhanced with some additional features while maintaining the single json structure of the original.

This site also comes with new themes (unfortunately not compatible with the AI or previous versions) that should be easier to modify for your own needs. 

Download the latest version here (Updated:  (12:34 3rd Apr 2025) W3C Validated code.) [This version accommodates HTML formatted NOAA reports and corrects the use of 'on' in all-time reports.  Note that if you opt to use these formatted NOAA reports you will need to re-generate ALL existing reports and upload them.]

You can view my site using the new default templates on Oaktree Weather .

Amendments since last revision

This is a full rebuild of the site.

Installing

Download the current zip file to you local machine and upload it to your web server.

  • Unzip it in the same location as your existing site - it will not overwrite the existing pages
    The new site uses .html pages whereas the existing default site uses .htm
    If you visit your site without specifying a page you will be taken to the new template pages,
    Specifying a page such as index.htm will display your old template pages.
  • Please clear your browser cache before viewing.

Your Own Pages

As with previous releases, the public website template also includes a template page.

The template.html page is provided to make it easier for you to add your own pages while retaining the look and feel of the website. The template page is called template.html.

Editing The template page shows all the different column layouts that are available. These are: 

ax-column1, ax-column2, ax-column3, ax-column4, ax-column5 and ax-column6
These will always try to display the indicated number of columns but as the screen becomes small will automatically collapse into fewer columns as appropriate.
If there are more panels than columns they will gracefully split onto additional rows while retaining their column settings.
Rows with fewer panels than columns will either stretch the remaining panels across the full width or distribute them centrally - this can be controlled by you.

For full details visit my wiki.

Editing the website menu

Please refer to my wiki for full details of the menu and how to edit it.

Changing the Theme and Other Settings

Please refer to my wiki for full information on configuring and setting up the alternative website.

Retrieved from "https://www.cumuluswiki.org/index.php?title=Default_Website_Development&oldid=12029"