The Miser Project

hybridForm Document-Format Exemplar (customize)
Construction Structure

miser>
hybridForm>


 

index>
0.0.0 2024-03-02 -09:48 -0800

Superior Structure: Miser Project Construction Structure (front porch)
Miser Project Construction Zone (front porch)
Local Infrastructure:
        index.htm  hybridForm Construction Structure (this placeholder page) - customize
 construction.htm  hybridForm Construction Zone - customize (optional)
      c000000.htm  hybridForm Construction Zone Diary and Job Jar - customize (optional with Construction Zone)
Immediate Content:         index.html Home Page (generated from index.md)
      h000000.htm   hybridForm Technical Notes and Diary
- customize with distinct prefix (likely)
      h000001.htm   hybridForm Technical Articles Catalog
- customize
   hybridForm.txt   hybridForm Manifest and TODOs
- customize (optional, with others)

 
Subordinate Structure:          yyyy/      Articles Initiated in yyyy - customize, expand from year to year                 

Status:


The Construction and Content Material here was created in conformance with the 2023-11-04 style and location requirements of the
Site Refactoring/Preservation Project.  Check that folder for additional details of the approach to correction and upgrade.

 

You've reached hybridForm/ , a portion of the Miser Project web site. 

This area is part of the engineering, construction management, maintenance, and infrastructure for the Miser Project web presence.  You are welcome to explore this and other construction-information pages.   You'll need your hard hat and safety shoes.  

When there is more content for this area, the entrance to this section will have a "home page" that provides access to that content.  Sometimes the "home page" (usually an index.html page) is removed to block access while the construction crew is blasting in the area.  If you are looking for the content, try again later or, if you are losing patience, encourage orcmid to provide it. 

Revision History:
0.0.0 2024-03-02-17:48Z hybridForm topic/ Construction Structure boilerplate creation
Customized for exemplar for a standard topic/index.htm  exemplar.

Exemplar Customization

This area is an  annotated exemplar, a kind of template this in the form it specifies, for use as boilerplate in creation of a topic section and also subordinate accession-numbered articles and components.  The practice is to copy (in the file manager, not FrontPage) as much of the entire hybridForm/ folder as needed to a new destination at the appropriate level in a project.  Then modify that copy, by renaming the files and editing in FrontPage (for HTML pages) or text editor (for Markdown pages)  to start a new topic and subordinate material at the "topic/" location.  That should be at the same level as this hybridForm/ and  construction/.  Subordinate exemplar portions can be copied repeatedly to expand subtrees on "topic/yyyy/mm/" paths.

IMPORTANT: This scheme is workable because relative URLs are used for cross-reference to templates and  other materials under construction/.  The congruence among Construction Material templates and other articles allows project-dependent features to be connected automatically using the same relative references.  Additional guidance on the customization of hybridForm exemplar pages is provided on the Construction Structure and on the exemplar pages under the hybridForm topic.  Editing of the extracted copies must then be done.  After there is some initial material, it may be easier to clone existing already-customized subordinate folders as boilerplate.

WARNING: Over time, different Construction Material, construction/, folders have variations in their construction/yyyy/mm/ additions that are sources for included components into web pages.  The key variations are for ClustrMap inclusion and the revision/refactoring notifications.  This is resolved on GitHub by employing the organization of  orcmid.github.io/construction/ as the standard arrangement, with appropriate adjustments for images/.

For customizaion of this exemplar page,

  1. In the top banner, the site/project (construction) image should already appear correct in the left cell.  The link should be to "../", the project home directory.
  2. In the title section of the top banner, the title "hybridForm Document-Format Exemplar (customize) should be replaced by the title of the topic being set up.
  3. In the far right block of the top banner, without altering the links, change the "hybridForm" link to the name of the topic/ folder.  The link should remain "./".  The name of this file, index (absent .htm) should have the correct link to "index.htm".
  4. In the Local Infrastructure, the phrase "hybridForm" in the three titles should be changed to use the topic name.
  5. In the Local Infrastructure, if there is no Construction Zone (unlikely), the entries for construction.htm and c000000.htm should be removed.  Since c000000 is relevant to the customization of the exemplar for the topic, the Zone should be retained at least long enough to complete the customization/repaving.  It is also valuable as the article sub-folders are added and expanded.
  6. In the Immediate Content, the name "hybridForm" should be changed to the topic name in those three occurrences. 
  7. In the Immediate Content, the h000000 and h000001 names should have the "h" replaced by the prefix chosen for the topic and its articles.  The links in the titles for those two should be to the already-renamed .htm files.
  8. In the Immediate Content, if the hybridForm.txt has been retained, possibly renamed to topic.txt and edited as boilerplate, correct the entry and the link in the title.  If there is no retention in either form, remove that entry from Immediate Content.
  9. For Subordinate Structure, if the yyyy substructure is to be retained as an exemplar for cloning of actual substructures, copy the entry to Local Infrastructure.  Otherwise, replace the Subordinate Structure with correct actual entries for subordinate article years.  Replace that entry with "[none]" if there is no actual subordinate structure (yet).
  10. Adjust the Revision History to reflect the initialization of this page.  Retain the supplied 0.0.0 to reflect this exemplar origin.  For the transposed new version, note the format of revision-number anchors and the links from the version specified in the right block of the page-top banner.
  11. On the properties for this file, revise it to reflect the actual article this is a page for.
  12. No changes should be required in the footer banner except for the "created" entry and possible identity and link to the author.  Verify that there are no mistaken links in that banner.
  13. When the customization is complete, delete this complete "Template Customization" section and commit this repurposed version to the repository.
  14. The formatting of table entries and the way they are moved to in-progress and done (or other disposition), along with colorization plus cut-and-past into the reverse-chronological bunching of closed items can be discerned by comparison with in-use forms of this page in other parts of the web site. 

Construction Material (Hard Hat Area)

You are navigating Miser Project construction structure.

created 2024-02-11T23:15Z by orcmid