Used sub-directories in Pages folder

Author: irsbugs

conf.py

@@ -158,7 +158,7 @@
 # Alternative navigation links. Works the same way NAVIGATION_LINKS does,
 # although themes may not always support them. (translatable)
 # (Bootstrap 4: right-side of navbar, Bootblog 4: right side of title)
-# 2025-03-07 Ian. Implement Peter's drop down menus ideas.
+# 2025-03-07 Ian. Implement Peter's drop down menus ideas. Created folders. E.g. /steps/
 NAVIGATION_ALT_LINKS = {
     DEFAULT_LANG: (
         ('/index.html', '<strong>Home</strong>'), 
@@ -194,13 +194,13 @@
         ("/website-creation/", "<strong>Website Creation</strong>"),
         (
             (
-                ('/steps/', 'Overview of Steps'),
-                ('/step1/', '1 PythonAnywhere Account'),
-                ('/step2/', '2 Nikola Installation'),
-                ('/step3/', '3 Creating a Website'),
-                ('/step4/', '4 Website Tailoring'),
-                ('/step5/', '5 ReST Editor'),
-                ('/step6/', '6 Deploying to PythonAnywhere'),
+                ('/steps/steps/', 'Overview of Steps'),
+                ('/steps/step1/', '1 PythonAnywhere Account'),
+                ('/steps/step2/', '2 Nikola Installation'),
+                ('/steps/step3/', '3 Creating a Website'),
+                ('/steps/step4/', '4 Website Tailoring'),
+                ('/steps/step5/', '5 ReST Editor'),
+                ('/steps/step6/', '6 Deploying to PythonAnywhere'),
             ),
             'Steps'
         ),
@@ -209,20 +209,20 @@
         #("/rest_directive/", "reST Directive"),
         (
             (
-                ("/rest_editor/", "reST Editor"),
-                ("/rest_basics/", "reST Basics"),
-                ("/rest_directive/", "reST Directive"),
+                ("/rest/rest_editor/", "reST Editor"),
+                ("/rest/rest_basics/", "reST Basics"),
+                ("/rest/rest_directive/", "reST Directive"),
             ),
             'reST'
         ),                
         ("/nikola_basics/", "Nikola Basics"),
-        ("/pythonanywhere/", "Python Anywhere"),
+        ("/pythonanywhere/", "PythonAnywhere"),
         #("/about-us/", "About Us"),
         (
             (
-                ("/about-us/", "About Us"),        
-                ('/map/', 'Map'),
-                ('/history/', 'History'),
+                ("/about/about-us/", "About Us"),        
+                ('/about/map/', 'Map'),
+                ('/about/history/', 'History'),
             ),
             'About'
         ),        

pages/README.md

@@ -40,7 +40,7 @@ conf.py    <--- This python configuration file performs the loading of constants
                 used by Nikola every time the website is re-built. 
 ```
 
-**Tree diagram of the *src* branch directory and its sub-directories and files.** - 2025-03-06 
+**Tree diagram of the *src* branch directory and its sub-directories and files.** - 2025-03-07 
 
   <!--the line-height is reduced slightly so vertical lines do not have spaces-->  
   <p style="line-height: 0.99em; font-family: monospace, monospace;"> 
@@ -95,17 +95,21 @@ conf.py    <--- This python configuration file performs the loading of constants
   │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;└── ws9.png <br> 
   │ <br> 
   ├── pages <br> 
-  │&nbsp;&nbsp;&nbsp;├── about-us.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── about-us.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── history.md <br> 
-  │&nbsp;&nbsp;&nbsp;├── history.meta <br> 
+  │&nbsp;&nbsp;&nbsp;├── about <br>
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── about-us.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── about-us.rst <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── history.md <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── history.meta <br>
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── map.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;└── map.md <br> 
+  │&nbsp;&nbsp;&nbsp;│ <br>
   │&nbsp;&nbsp;&nbsp;├── index.md <br> 
   │&nbsp;&nbsp;&nbsp;├── index.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── map.md <br> 
-  │&nbsp;&nbsp;&nbsp;├── map.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── meeting <br> 
+  │&nbsp;&nbsp;&nbsp;│ <br> 
+  │&nbsp;&nbsp;&nbsp;├── meeting <br>   
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── meeting_overview.md <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;└── meeting_overview.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│ <br>  
   │&nbsp;&nbsp;&nbsp;├── meetup.md <br> 
   │&nbsp;&nbsp;&nbsp;├── meetup.meta <br> 
   │&nbsp;&nbsp;&nbsp;├── nikola_basics.meta <br> 
@@ -114,51 +118,57 @@ conf.py    <--- This python configuration file performs the loading of constants
   │&nbsp;&nbsp;&nbsp;├── pythonanywhere.rst <br>  
   │&nbsp;&nbsp;&nbsp;├── README.md <br> 
   │&nbsp;&nbsp;&nbsp;├── README.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│ <br>   
   │&nbsp;&nbsp;&nbsp;├── repository <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── general_code_examples.md <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── general_code_examples.meta <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── ncea_code_examples.md <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── ncea_code_examples.meta <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── repository_overview.md <br> 
   │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;└── repository_overview.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── rest_basics.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── rest_basics.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── rest_directive.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── rest_directive.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── rest_editor.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── rest_editor.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── step1.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── step1.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── step2.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── step2.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── step3.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── step3.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── step4.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── step4.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── step5.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── step5.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── step6.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── step6.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── steps.meta <br> 
-  │&nbsp;&nbsp;&nbsp;├── steps.rst <br> 
-  │&nbsp;&nbsp;&nbsp;├── website-creation.meta <br> 
-  │&nbsp;&nbsp;&nbsp;└── website-creation.rst <br> 
+  │&nbsp;&nbsp;&nbsp;│ <br>  
+  │&nbsp;&nbsp;&nbsp;├── rest <br>
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── rest_basics.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── rest_basics.rst <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── rest_directive.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── rest_directive.rst <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;├── rest_editor.meta <br> 
+  │&nbsp;&nbsp;&nbsp;│&nbsp;&nbsp;&nbsp;└── rest_editor.rst <br>
+  │&nbsp;&nbsp;&nbsp;│ <br> 
+  │&nbsp;&nbsp;&nbsp;└── steps <br>  
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step1.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step1.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step2.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step2.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step3.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step3.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step4.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step4.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step5.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step5.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step6.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── step6.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── steps.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── steps.rst <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;├── website-creation.meta <br> 
+  │&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;└── website-creation.rst <br> 
   │ <br> 
   ├── .gitignore <br> 
   └── conf.py <br> 
   </p> 
 
-Most directories can have a README.rst or README.md file that contains a brief explanation of what 
-is in that directory. 
+Directories in Github can have a README.rst or README.md file that contains a 
+brief explanation of the purpose of the directory. 
 
-Although the README files are passed to the "main" branch as .html files, their contents are not 
-normally displayed by the website.
+Although the README files are passed to the "main" branch as .html files, 
+their contents are not normally displayed by the website.
 
 
 Metadata Template for .rst files
 --------------------------------
 
-All *reStructuredText .rst* filenames should only use **a to z**, **0-9** and a literal dash **-**.
+All *reStructuredText .rst* filenames should only use **a to z**, **0-9** and 
+a literal dash **-**.
 
 This is what the *slug* metadata expects.
 
@@ -181,13 +191,15 @@ Write or Paste your document here...
 `[Goto Top] <#top>`_
 
 ```
-Github will display the .rst metadata as a table using three hyphens before and after the metadata,
-however a bug seems to cause it to not incorporate at least the last line of metadata.
+Github will display the .rst metadata as a table using three hyphens before and 
+after the metadata, however a bug seems to cause it to not incorporate at least 
+the last line of metadata.
 
 Metadata Template for .md files
 -------------------------------
 
-All *markdown .md* filenames should only use **a to z**, **0-9** and a literal dash **-**.
+All *markdown .md* filenames should only use **a to z**, **0-9** and a literal 
+dash **-**.
 
 This is what the *slug* metadata expects.
 
@@ -212,9 +224,9 @@ Write or Paste your document here...
 <br><hr>
 [Top](#top)
 ```
-When using Github to display a markdown .md file, the metadata can be presented as a table at the 
-top of the displayed content if three hyphens are placed above and below the metadata. In which
-case this is the .md template:
+When using Github to display a markdown .md file, the metadata can be presented 
+as a table at the top of the displayed content if three hyphens are placed 
+above and below the metadata. In which case this is the .md template:
 ```
 ---
 title: *My Title

pages/about-us.rst

@@ -0,0 +1,31 @@
+Hamilton Python Users Group ~ HamPUG
+====================================
+
+Kei runga tatou i Kirikiriroa i Aotearoa
+
+We are based in Hamilton in New Zealand.
+
+.. raw:: html
+ 
+     <!--Add http to announce Status of HamPUG. Ian 2025-03-07: Used background-colour red, and Warning gives red border-->
+    <div class="warning" style='padding:0.1em; background-color:red; color:white; border-radius: 10px;'> 
+        <span>
+            <h2 style='margin-top:1em; text-align:center'>
+                <b>
+                Status of the Hamilton Python Users Group
+                </b>
+            </h2>
+            <p style='margin-left:1em;'>
+                The Hamilton Python Users Group operated monthly meetings for 10 years 
+                from February 2014 to September 2023. We no longer have monthly meetings.
+            <br>
+                This <i>Nikola</i> generated website has been kept as an historical 
+                record of HamPUG. We haved a repository on Github for our Python code 
+                and presentation slides, etc. Use 
+                <a href="/repository/repository_overview">Repository</a> and 
+                <a href="/meeting/meeting_overview">Meetings</a> 
+                tabs for links to this information.
+            </p>     
+        </span>
+    </div>   
+    

pages/about-us.meta renamed to pages/about/about-us.meta

@@ -1,16 +1,26 @@
-
 ## History
 
-<!--Add http to announce Status of HamPUG. Ian 2025-03-06: Used background-colour red, and Warning gives red border-->
+<!--Add http to announce Status of HamPUG. Ian 2025-03-07: Used background-colour red, and Warning gives red border-->
 <div class="warning" style='padding:0.1em; background-color:red; color:white; border-radius: 10px;'> 
-<span>
-<h2 style='margin-top:1em; text-align:center'>
-<b>Status of the Hamilton Python Users Group</b></h2>
-<p style='margin-left:1em;'>
-The Hamilton Python Users Group operated monthly meetings for 10 years from February 2014 to September 2023. We no longer have monthly meetings.<br>
-This <i>Nikola</i> generated website has been kept as an historical record of HamPUG. We haved a repository on Github for our Python code and presentation slides, etc. Use <i>Repository</i> and <i>Meetings</i> tabs for links to this information. 
-</span></div>
-
+    <span>
+        <h2 style='margin-top:1em; text-align:center'>
+            <b>
+            Status of the Hamilton Python Users Group
+            </b>
+        </h2>
+        <p style='margin-left:1em;'>
+            The Hamilton Python Users Group operated monthly meetings for 10 years 
+            from February 2014 to September 2023. We no longer have monthly meetings.
+        <br>
+            This <i>Nikola</i> generated website has been kept as an historical 
+            record of HamPUG. We haved a repository on Github for our Python code 
+            and presentation slides, etc. Use 
+            <a href="/repository/repository_overview">Repository</a> and 
+            <a href="/meeting/meeting_overview">Meetings</a> 
+            tabs for links to this information.
+        </p>     
+    </span>
+</div>
 
 Some Hamilton based Python enthusiasts used to regularly travel to Auckland to attend the
 meetings of the Auckland Python Users Group. They put forward the idea of having

pages/about/about-us.rst

@@ -0,0 +1,37 @@
+## Map
+
+<!--Add http to announce Status of HamPUG. Ian 2025-03-07: Used background-colour red, and Warning gives red border-->
+<div class="warning" style='padding:0.1em; background-color:red; color:white; border-radius: 10px;'> 
+    <span>
+        <h2 style='margin-top:1em; text-align:center'>
+            <b>
+            Status of the Hamilton Python Users Group
+            </b>
+        </h2>
+        <p style='margin-left:1em;'>
+            The Hamilton Python Users Group operated monthly meetings for 10 years 
+            from February 2014 to September 2023. We no longer have monthly meetings.
+        <br>
+            This <i>Nikola</i> generated website has been kept as an historical 
+            record of HamPUG. We haved a repository on Github for our Python code 
+            and presentation slides, etc. Use 
+            <a href="/repository/repository_overview">Repository</a> and 
+            <a href="/meeting/meeting_overview">Meetings</a> 
+            tabs for links to this information.
+        </p>     
+    </span>
+</div>
+
+![map](/images/ms4g02-map.png){: style="float:right", width=60%}
+
+HamPUG meetings are held at Waikato University building **MS4.G.02** at 7pm on the
+second Monday of the month (except January). In the event that the Monday is a 
+public holiday then the meeting is held the next normal business day.
+
+The map below shows Hillcrest Road running through the middle from north to south. 
+
+When travelling by car, exit Hillcrest Road at Gate 7 and drive around the 
+Law Building and Management School to get to parking next to MS4.G.02. In the
+evenings it is OK to park in the *reserved* parking lots.
+
+

pages/history.md renamed to pages/about/history.md

@@ -7,16 +7,27 @@ Replaces failed Web2Py site at hampug.pythonanywhere.com
 
 ## Hamilton Python Users Group
 
-<!--Add http to announce Status of HamPUG. Ian 2025-03-06: Used background-colour red, and Warning gives red border-->
+<!--Add http to announce Status of HamPUG. Ian 2025-03-07: Used background-colour red, and Warning gives red border-->
 <div class="warning" style='padding:0.1em; background-color:red; color:white; border-radius: 10px;'> 
-<span>
-<h2 style='margin-top:1em; text-align:center'>
-<b>Status of the Hamilton Python Users Group</b></h2>
-<p style='margin-left:1em;'>
-The Hamilton Python Users Group operated monthly meetings for 10 years from February 2014 to September 2023. We no longer have monthly meetings.<br>
-This <i>Nikola</i> generated website has been kept as an historical record of HamPUG. We haved a repository on Github for our Python code and presentation slides, etc. Use <i>Repository</i> and <i>Meetings</i> tabs for links to this information. 
-</span></div>
-
+    <span>
+        <h2 style='margin-top:1em; text-align:center'>
+            <b>
+            Status of the Hamilton Python Users Group
+            </b>
+        </h2>
+        <p style='margin-left:1em;'>
+            The Hamilton Python Users Group operated monthly meetings for 10 years 
+            from February 2014 to September 2023. We no longer have monthly meetings.
+        <br>
+            This <i>Nikola</i> generated website has been kept as an historical 
+            record of HamPUG. We haved a repository on Github for our Python code 
+            and presentation slides, etc. Use 
+            <a href="/repository/repository_overview">Repository</a> and 
+            <a href="/meeting/meeting_overview">Meetings</a> 
+            tabs for links to this information.
+        </p>     
+    </span>
+</div>
 
 The **Ham**ilton **P**ython **U**sers **G**roup (HamPUG) is for anyone who is enthusiastic in
 writing and learning the [Python](https://www.python.org/) programming language.