OSDN Git Service

Initial commit.
authorKeith Marshall <keith@users.osdn.me>
Tue, 6 Oct 2020 21:01:06 +0000 (22:01 +0100)
committerKeith Marshall <keith@users.osdn.me>
Tue, 6 Oct 2020 21:01:06 +0000 (22:01 +0100)
* index.html header.html about.html: New files.
* site.css site.js logo.png: Likewise.

about.html [new file with mode: 0644]
header.html [new file with mode: 0644]
index.html [new file with mode: 0644]
logo.png [new file with mode: 0644]
site.css [new file with mode: 0644]
site.js [new file with mode: 0644]

diff --git a/about.html b/about.html
new file mode 100644 (file)
index 0000000..5978eb9
--- /dev/null
@@ -0,0 +1,180 @@
+<!DOCTYPE HTML><!--
+ *
+ * about.html
+ *
+ * $Id$
+ *
+ * Written by Keith Marshall <keith@users.osdn.me>
+ * Copyright (C) 2020, MinGW.org Project
+ *
+ *
+ * Redistribution and use in source and 'compiled' forms (SGML, HTML,
+ * PDF, PostScript, RTF, etc) with or without modification, are permitted
+ * provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer as
+ *    the first lines of this file, unmodified.
+ *
+ * 2. Redistributions in compiled form (transformed to other DTDs,
+ *    converted to PDF, PostScript, RTF and other formats) must
+ *    reproduce the above copyright notice, this list of conditions
+ *    and the following disclaimer in the documentation and/or other
+ *    materials provided with the distribution.
+ *
+ * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
+ * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGE.
+ *
+ *
+ * Note: this page assumes browser support for the following numeric
+ * HTML entity codes:
+ *
+ *    &#8209;  non-breaking hyphen
+ *    &#8217;  typographic apostrophe
+ *    &#8220;   left (opening) typographic double quote
+ *    &#8221;   right (closing) typographic double quote
+ *
+-->
+<p><strong>MinGW</strong>,
+a contraction of &#8220;Minimalist GNU for Windows&#8221;,
+is a minimalist development environment
+for native Microsoft Windows applications.
+</p>
+<p><strong>MinGW</strong> is a registered trademark of
+<a href="https://www.spi-inc.org/projects/mingw/"
+>Software in the Public Interest Inc.</a>,
+registration
+<a href="https://tsdr.uspto.gov/#caseNumber=86017856&#038;
+caseSearchType=US_APPLICATION&#038;caseType=DEFAULT&#038;
+searchType=statusSearch">number 86017856</a>;
+it has been registered on behalf of MinGW.org,
+and its use by any other project is unauthorized.
+</p>
+<p><strong>MinGW</strong>
+provides a complete Open Source programming tool set which is
+suitable for the development of native MS-Windows applications,
+and which do not depend on any 3rd&#8209;party C&#8209;Runtime DLLs.
+(It <strong><em>does</em></strong>
+depend on a number of DLLs provided by Microsoft
+themselves, as components of the operating system;
+most notable among these is MSVCRT.DLL,
+the Microsoft C runtime library.
+Additionally, threaded applications <strong><em>must</em></strong>
+ship with a freely distributable thread support DLL,
+provided as part of MinGW itself).
+</p>
+<p><strong>MinGW</strong>
+compilers provide access to the functionality of the
+Microsoft C runtime and some language&#8209;specific runtimes.
+MinGW, being Minimalist, <strong>does not, and never will, attempt to
+provide a full POSIX runtime environment for POSIX application deployment
+on MS&#8209;Windows</strong>.
+If you want POSIX application deployment on this platform,
+please consider
+<a href="http://www.cygwin.com">Cygwin</a> instead.
+</p>
+<p>Primarily intended for use by developers working on the native
+MS&#8209;Windows platform,
+but also available for cross&#8209;hosted use,
+(<a href="#cross-compile">see note below</a>),
+<strong>MinGW</strong> includes:&mdash;
+</p>
+<ul>
+<li><a href="https://osdn.net/projects/mingw/releases/p15691"
+>A port of the GNU Compiler Collection</a>
+(GCC), including C, C++, ADA and Fortran compilers;
+</li>
+<li><a href="https://osdn.net/projects/mingw/releases/p15608"
+>GNU Binutils for Windows</a> (assembler, linker, archive manager)
+</li>
+<li>A command&#8209;line installer,
+with optional GUI front&#8209;end,
+(<a href="https://osdn.net/projects/mingw/releases/p15522"
+>mingw&#8209;get</a>)
+for MinGW and MSYS deployment on MS&#8209;Windows</li>
+<li>A GUI first&#8209;time setup tool
+(<a href="https://osdn.net/projects/mingw/downloads/68260/mingw-get-setup.exe/"
+>mingw&#8209;get&#8209;setup</a>),
+to get you up and running with
+<a href="https://osdn.net/projects/mingw/releases/p15522"
+>mingw&#8209;get</a>.
+</li>
+</ul>
+<div><p><strong>MSYS</strong>,
+a contraction of &#8220;Minimal SYStem&#8221;,
+is a Bourne Shell command line interpreter system.
+Offered as an alternative to Microsoft&#8217;s cmd.exe,
+this provides a general purpose command line environment,
+which is particularly suited to use with <strong>MinGW</strong>,
+for porting of many Open Source applications to the
+MS&#8209;Windows platform;
+a light&#8209;weight fork of Cygwin&#8209;1.3,
+it includes a small selection of Unix tools,
+chosen to facilitate that objective.
+</p>
+<hr /></div>
+<h3>Project Mailing Lists</h3>
+<p>The MinGW.org Project operates one active discussion
+<a rel="noopener noreferrer" target="_blank"
+ href="https://lists.osdn.me/mailman/listinfo/mingw-users"
+>mailing list</a>,
+to which you are encouraged to subscribe,
+and to participate in the discussion.
+Please use this list,
+if you wish to seek advice on using MinGW;
+<strong>do not</strong> create wiki pages, or add comments to wiki pages,
+to ask questions.
+</p>
+<p>In addition to the above discussion list, we also operate
+<a rel="noopener noreferrer" target="_blank"
+ href="https://lists.osdn.me/mailman/listinfo/mingw-notify"
+>a read&#8209;only mailing list</a>,
+for posting of notifications about project activity;
+while this may be of more interest to project contributors,
+you are also welcome to subscribe to this list,
+if you would like to receive such notifications.
+</p>
+<p>Archives of past postings,
+to each of these mailing lists, are available
+<a rel="noopener noreferrer" target="_blank"
+ href="https://osdn.net/projects/mingw/lists/"
+>on OSDN</a>.
+There are also historical archives of older
+&mdash; now defunct &mdash;
+project mailing lists available
+<a rel="noopener noreferrer" target="_blank"
+ href="https://sourceforge.net/p/mingw/mailman/"
+>on SourceForge.net</a>;
+subscription to these older lists is no longer permitted.
+</p>
+<hr />
+<h3 id="cross-compile">Using MinGW for Cross-Hosted Development</h3>
+<p>While <strong>MinGW</strong> provides tools
+primarily intended for use by developers working on the
+MS&#8209;Windows platform,
+many developers choose to run cross&#8209;compiler
+variants of the <strong>MinGW</strong> tools,
+on platforms such as GNU/Linux,
+to generate applications for deployment on MS&#8209;Windows.
+To facilitate this development model,
+many Linux distributors provide the necessary cross-compiler tools,
+derived from the <strong>MinGW</strong> tool chains;
+such cross&#8209;compiler tool chains are
+<strong><em>not</em></strong> directly supported by MinGW.org,
+although we may be able to help out with advice related to the specifics
+of MS&#8209;Windows applications development,
+common to the use of our own native tool chains
+and to such cross&#8209;compilers.
+</p>
+
+<!-- $RCSfile$: end of file -->
diff --git a/header.html b/header.html
new file mode 100644 (file)
index 0000000..03ef550
--- /dev/null
@@ -0,0 +1,55 @@
+<!DOCTYPE HTML><!--
+ *
+ * header.html
+ *
+ * Specify the content for the fixed-position page header block,
+ * which is common to all MinGW.org web pages.
+ *
+ *
+ * $Id$
+ *
+ * Written by Keith Marshall <keith@users.osdn.me>
+ * Copyright (C) 2020, MinGW.org Project
+ *
+ *
+ * Redistribution and use in source and 'compiled' forms (SGML, HTML,
+ * PDF, PostScript, RTF, etc) with or without modification, are permitted
+ * provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer as
+ *    the first lines of this file, unmodified.
+ *
+ * 2. Redistributions in compiled form (transformed to other DTDs,
+ *    converted to PDF, PostScript, RTF and other formats) must
+ *    reproduce the above copyright notice, this list of conditions
+ *    and the following disclaimer in the documentation and/or other
+ *    materials provided with the distribution.
+ *
+ * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
+ * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGE.
+ *
+-->
+<a href="index.html"><div id="logo"></div></a>
+<div class="text">
+  <h1>Minimalist GNU for Windows</h1>
+  <ul id="navbar">
+    <li><a href="index.html">Home</a></li>
+    <li><a href="#">Downloads</a></li>
+    <li><a href="#">Licensing</a></li>
+    <li><a href="#">Documentation</a></li>
+    <li><a href="#">Contact Us</a></li>
+  </ul>
+</div>
+
+<!-- $RCSfile$: end of file -->
diff --git a/index.html b/index.html
new file mode 100644 (file)
index 0000000..5be6e18
--- /dev/null
@@ -0,0 +1,59 @@
+<!DOCTYPE HTML><!--
+ *
+ * index.html
+ *
+ * $Id$
+ *
+ * Written by Keith Marshall <keith@users.osdn.me>
+ * Copyright (C) 2020, MinGW.org Project
+ *
+ *
+ * Redistribution and use in source and 'compiled' forms (SGML, HTML,
+ * PDF, PostScript, RTF, etc) with or without modification, are permitted
+ * provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer as
+ *    the first lines of this file, unmodified.
+ *
+ * 2. Redistributions in compiled form (transformed to other DTDs,
+ *    converted to PDF, PostScript, RTF and other formats) must
+ *    reproduce the above copyright notice, this list of conditions
+ *    and the following disclaimer in the documentation and/or other
+ *    materials provided with the distribution.
+ *
+ * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
+ * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGE.
+ *
+-->
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Welcome to MinGW.org</title>
+    <link href="https://fonts.googleapis.com/css2?family=Alegreya+Sans+SC:wght@500&family=Roboto&display=swap" rel="stylesheet" />
+    <link rel="stylesheet" href="site.css" />
+    <script src="site.js"></script>
+  </head>
+  <body onload="new_page('about.html', 'Home of the MinGW and MSYS Projects')">
+    <div id="header"></div>
+    <div class="page-view">
+      <div class="masthead">
+       <h1 id="page-title"></h1>
+       <h2 id="page-subtitle"></h2>
+      </div><!-- masthead --><hr />
+      <div id="page-content"></div>
+    </div><!-- page-view -->
+  </body>
+</html>
+
+<!-- $RCSfile$: end of file -->
diff --git a/logo.png b/logo.png
new file mode 100644 (file)
index 0000000..549cb3d
Binary files /dev/null and b/logo.png differ
diff --git a/site.css b/site.css
new file mode 100644 (file)
index 0000000..350264c
--- /dev/null
+++ b/site.css
@@ -0,0 +1,216 @@
+/*
+ * site.css
+ *
+ * Rules for application of consistent styling, for all regular pages,
+ * across the MinGW.org site.
+ *
+ *
+ * $Id$
+ *
+ * Written by Keith Marshall <keith@users.osdn.me>
+ * Copyright (C) 2020, MinGW.org Project
+ *
+ *
+ * Redistribution and use in source and 'compiled' forms (SGML, HTML,
+ * PDF, PostScript, RTF, etc) with or without modification, are permitted
+ * provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer as
+ *    the first lines of this file, unmodified.
+ *
+ * 2. Redistributions in compiled form (transformed to other DTDs,
+ *    converted to PDF, PostScript, RTF and other formats) must
+ *    reproduce the above copyright notice, this list of conditions
+ *    and the following disclaimer in the documentation and/or other
+ *    materials provided with the distribution.
+ *
+ * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
+ * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGE.
+ *
+ */
+
+/* General page layout and formatting
+ * ==================================
+ */
+body
+{ /* Default style, applicable to all normal page content; favour
+   * Google's "Roboto" sans-serif web-font, at 14pt, with blue-black
+   * text colour, on a pale blue-grey background; centre text within
+   * the viewport, with no padding.
+   */
+  margin: 0 auto; padding 0;
+  font-family: Roboto, verdana, sans-serif; font-size: 14pt;
+  color: #000066; background-color: #e9e9ff;
+}
+h3
+{ /* We reserve h1 and h2 heading levels for page title, and
+   * subtitle respectively; thus, h3 becomes the first level
+   * available for section headings.  Preserve the browser's
+   * default h3 styling, but pull the following paragraph a
+   * bit closer.
+   */
+  margin-bottom: -0.2em;
+}
+hr
+{ /* Match the colour of horizontal page dividing rules to that
+   * of the text.
+   */
+  color: #000066;
+}
+a
+{ /* Links are distiguisable by use of a contrasting text colour;
+   * there is no need to underline them too!
+   */
+  text-decoration: none;
+}
+a:visited
+{ /* Visited links are further distinguishable, by use of an
+   * alternative contrasting text colour.
+   */
+  color: #aa00cc;
+}
+p
+{ /* Use the browser's default paragraph styling, but tighten the
+   * inter-paragraph spacing...
+   */
+  margin-top: 0.6em; margin-bottom: 0;
+}
+p:first-child
+{ /* ...while maintaining a deeper space before the first in any
+   * free-standing text division.
+   */
+  margin-top: 1.3em;
+}
+hr+p, p+hr
+{ /* Also maintain a deeper space between paragraph text and any
+   * intervening horizontal rule.
+   */
+  margin-top: 1.3em;
+}
+p+ul
+{ /* Keep any unordered list closer to preceding paragraph text
+   * than normal inter-paragraph spacing, but separated slightly
+   * more than single-line text spacing.
+   */
+  margin-top: 0.3em; margin-bottom: 0;
+}
+
+
+/* Fixed position page header block formatting
+ * ===========================================
+ */
+#header
+{ /* All pages share a common header block layout; it will be fixed
+   * at the top of the viewport, across its full width, and variable
+   * page content will scroll below it.
+   */
+  position: fixed; z-index: 50; top: 0; width: 100%; height: 70px;
+  border-bottom: 5px solid #336699; background-color: #ccccff; opacity: 1;
+}
+#logo
+{ /* Encapsulated within the header block, place a single copy of
+   * the graphical site logo to the left of the region.
+   */
+  float: left; height: 100%; width: 15%;
+  background: url("logo.png") no-repeat center;
+}
+#header .text
+{ /* Allocate the region of the header block, to the right of the
+   * logo, for display of centred mid-blue-grey text, in Google's
+   * "Alegreya Sans" small-caps web-font, at nominal 14pt size.
+   */
+  float: both; width = 100%; text-align: center;
+  font-family: "Alegreya Sans SC", verdana, sans-serif; font-size: 14pt;
+  color: #336699; font-variant: small-caps; font-weight: bold;
+  white-space: nowrap; overflow: none;
+}
+#header .text h1
+{ /* The primary text, in the header block, is set as a level one
+   * heading, (and thus at double the nominal font size); also set
+   * it with expanded tracking.
+   */
+  margin: 0; padding: 0; letter-spacing: 0.2em; word-spacing: 0.4em;
+}
+#navbar
+{ /* The navigation tab-bar is also encapsulated within the header
+   * block; implemented as an unordered list, without bullet marks,
+   * it is placed centrally, with its top set at two logical pixel
+   * heights below the top level (h1) heading text.
+   */
+  list-style: none; margin-top: 2px;
+}
+#navbar li
+{ /* Each navigation tab is represented by a list item, arranged
+   * within an inline-block display, (hence laid out horizontally).
+   * Each tab is styled to give the appearance of a row of filing
+   * cabinet tabs, with the entire row occupying 99% of available
+   * display width, (after deduction of the 15% reserved for the
+   * logo); hence the width of each tab (currently there are 5)
+   * becomes (99 - 15) / 5 = 16.8%.
+   */
+  display: inline-block;
+  min-width: 16.8%; margin-left: 1px; margin-right: 1px;
+  border-top: 1px solid; border-left: 1px solid; border-right: 2px solid;
+  border-top-left-radius: 7px; border-top-right-radius: 7px;
+  border-bottom-style: none; border-color: #336699;
+  color: #003366; background-color: #d9d9ff;
+}
+#navbar li:hover
+{ /* Invert navigation tab colours, on mouse-over.
+   */
+  color: #ffffff; background-color: #6699cc;
+}
+#navbar li a
+{ /* Make link anchors, on navigation tabs, fill the entire area
+   * of their respective tabs, while preserving the text colour
+   * theme of the page header block.
+   */
+  display: block; color: inherit;
+}
+
+
+/* General page content formatting
+ * ===============================
+ */
+.page-view
+{ /* Set the page content to begin immediately below the reserved
+   * space for the fixed page header; (it may subsequently scroll,
+   * to be occluded behind the header).
+   */
+  position: absolute; top: 70px;
+  text-align: justify; padding: 0 3% 1.5em;
+}
+.masthead
+{ /* Nominally placed at the top of the page content region, we
+   * allow for a "masthead" region, offset from the main content
+   * by one vertical em-space, in which the page title, and any
+   * desired page subtitle, may be placed.
+   */
+  margin-bottom: 1em;
+}
+.masthead h1
+{ /* Within the "masthead" region, the page title will be set as
+   * a level one heading, with no space below.
+   */
+  margin-bottom: 0;
+}
+.masthead h2
+{ /* Similarly, if present, the page subtitle will be set as a
+   * level two heading, at default size for such headings, but
+   * with no emboldening.
+   */
+  margin: 0; padding-top: 1px; font-weight: normal;
+}
+
+/* $RCSfile$: end of file */
diff --git a/site.js b/site.js
new file mode 100644 (file)
index 0000000..df255c7
--- /dev/null
+++ b/site.js
@@ -0,0 +1,77 @@
+/*
+ * site.js
+ *
+ * General purpose functions for manipulation of page content.
+ *
+ *
+ * $Id$
+ *
+ * Written by Keith Marshall <keith@users.osdn.me>
+ * Copyright (C) 2020, MinGW.org Project
+ *
+ *
+ * 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, this permission notice, and the following
+ * disclaimer 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 OF OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ *
+ */
+function set_content( item, value )
+{ /* Replace the existing content, if any, of the HTML element with
+   * id attribute named "item", (if such an element exists), with new
+   * content as specified by "value".
+   */
+  var element = document.getElementById( item );
+  if( element ) element.innerHTML = value;
+}
+
+function load_content( container, src )
+{ /* Set the content of the specified HTML "container" element, by
+   * injection of the entire contents of an external file which is
+   * fetched by http server request; (either an http, or an https,
+   * server connection is required; does not work for local files).
+   */
+  var request_handler = new XMLHttpRequest();
+  request_handler.onreadystatechange = function()
+  { if( (this.readyState == this.DONE) && (this.status == 200) )
+      set_content( container, this.responseText );
+  }
+  request_handler.open( "GET", src, true );
+  request_handler.send();
+}
+
+function load_page_content( src, subtitle )
+{ /* Propagate the HTML document title to the "masthead" display,
+   * update the displayed page subtitle, (which may be null), and
+   * load the page content from the specified "src" file.
+   */
+  set_content( "page-title", document.title );
+  set_content( "page-subtitle", subtitle );
+  load_content( "page-content", src );
+}
+
+function new_page( src, subtitle )
+{ /* Create a new page display, starting from scratch; assign the
+   * displayed title from the HTML document title attribute, adding
+   * the specified subtitle, lay out the standard page header block,
+   * and load the page content from the "src" file.
+   */
+  load_content( "header", "header.html" );
+  load_page_content( src, subtitle );
+}
+
+/* $RCSfile$: end of file */