checkpoint initial inc content
Details of how this content will be used is found in part, in the `/inc/README.md` file and in part in the tools that will use this content. The content of this directory will likely change soon. This content is a placeholder.
This commit is contained in:
Landon Curt Noll committed
1 parent
122142d39d
commit
49bd63d363
16 files changed
+325
No files matched your search
+194
@@ -0,0 +1,194 @@
|
||||
# inc
|
||||
|
||||
The [inc](/inc) directory holds content that is used by the
|
||||
[build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
|
||||
|
||||
**HOWEVER ...** XXX
|
||||
|
||||
While the build-ioccc repo is not ready, tools under
|
||||
[temp-test-ioccc repo tmp directory](https://github.com/ioccc-src/temp-test-ioccc/tree/master/tmp)
|
||||
will use files in this directory.
|
||||
|
||||
|
||||
## Why the name inc?
|
||||
|
||||
We use inc because "include" would be misleading for both C and because
|
||||
the contents of HTML files under [inc](/inc) is not really included
|
||||
by the web server nor the browser. Content of HTML files is
|
||||
processed by tools in the [build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master).
|
||||
Processing can include substitution of strings of the form _%%CURDS%%_ with some command
|
||||
line supplied value by the tool in question.
|
||||
|
||||
|
||||
## How HTML content is built
|
||||
|
||||
Files under the [inc](/inc) directory contain HTML fragments that the
|
||||
[build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
|
||||
tools use to form HTML content for the official IOCCC web site](https://www.ioccc.org).
|
||||
|
||||
The canonical way that HTML content is built uses, by default, files of the form:
|
||||
|
||||
```
|
||||
*.default.html
|
||||
```
|
||||
|
||||
The command line of a [build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
|
||||
tool, and perhaps modified via [exception file](/inc.exception.md) file may change
|
||||
to using a different filename, such as using `body.graybg.html` instead of the default `body.default.html`.
|
||||
In some cases the [exception file](/inc.exception.md) may disable forming HTML content altogether.
|
||||
|
||||
The following is the canonical order for building HTML content from a winner `README.md` file:
|
||||
|
||||
0. top.default.html
|
||||
1. head.default.html
|
||||
2. body.default.html
|
||||
3. before-row.default.html
|
||||
4. page-top.default.html
|
||||
5. before-row.default.html
|
||||
6. before-leftcolumn.default.html
|
||||
7. sidenav.default.html
|
||||
8. before-rightcolumn.default.html
|
||||
9. before-content.default.html
|
||||
|
||||
At this point, page content such as that produced by the `pandoc` tool is inserted.
|
||||
This is followed by canonical order for the end of the HTML content:
|
||||
|
||||
10. after-content.default.html
|
||||
11. after-rightcolumn.default.html
|
||||
12. after-row.default.html
|
||||
13. page-bottom.default.html
|
||||
14. bottom.default.html
|
||||
|
||||
In some cases, the above canonical order may be skipped.
|
||||
|
||||
Files of the form will **NOT** exist, instead the tool will skip using such a file:
|
||||
|
||||
```
|
||||
*.devnull.html
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
## Use CAUTION when modifying inc files
|
||||
|
||||
Some of the files under this directory are used to form **MOST** of the HTML content
|
||||
on the [official IOCCC web site](https://www.ioccc.org):
|
||||
|
||||
**HOWEVER ...** XXX
|
||||
|
||||
Well, until the [official IOCCC web site](https://www.ioccc.org), via the
|
||||
[IOCCC winner repo](https://github.com/ioccc-src/winner) is ready for the mass pull request/merge,
|
||||
these files are used to form **MOST** of the HTML content
|
||||
on the [experimental web site](https://ioccc-src.github.io/temp-test-ioccc/).
|
||||
|
||||
... and in particular files under [inc](/inc) that are of the form (called default HTML files) ...:
|
||||
|
||||
```
|
||||
*.default.html
|
||||
```
|
||||
|
||||
... contain default content used to form IOCCC HTML / IOCCC web pages.
|
||||
|
||||
Instead of editing the default HTML files in order to fix a special web page,
|
||||
consider making a copy of the default file and modifying the [use.md](/inc/use.md)
|
||||
file to refer to the copy instead. That way your special case situation will
|
||||
not impact **MOST** of the HTML content.
|
||||
|
||||
|
||||
## Why do we do not use certain well know HTML technology
|
||||
|
||||
You may wonder why we need these files in the first place.
|
||||
You may wonder why we even need the tools in the
|
||||
[build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
|
||||
when there other solutions available to form web pages.
|
||||
|
||||
|
||||
### <a name="static-only"></a>Static web pages only
|
||||
|
||||
Here are some reasons why we are using these files and
|
||||
special tools to create HTML content / IOCCC web pages:
|
||||
|
||||
We host [official IOCCC web site](https://www.ioccc.org) via [GitHub pages](https://pages.github.com).
|
||||
As of the time this file written, **only static web pages are supported**.
|
||||
|
||||
|
||||
### Cannot use server side include
|
||||
|
||||
We use [static web pages](#static-only), so use of "server side include" is not available to the IOCCC.
|
||||
|
||||
For example, Apache SSI "#include" does not work on [GitHub pages](https://pages.github.com).
|
||||
|
||||
|
||||
### Cannot use a back-end database
|
||||
|
||||
We use [static web pages](#static-only), so use of "back-end database" is not available to the IOCCC.
|
||||
|
||||
|
||||
### <a name="why-github"></a>Cannot use non-GitHub web servers
|
||||
|
||||
The [GitHub pages](https://pages.github.com) have the distributed server capacity needed to handle
|
||||
the **huge download volume** or [Slashdot effect](https://en.wikipedia.org/wiki/Slashdot_effect)
|
||||
that happens when a IOCCC winners are published.
|
||||
|
||||
Most so-called low cost web hosting sites have a somewhat hidden excessive bandwidth charge
|
||||
and/or cap bandwidth when the volume gets too high, and/or do not have the infrastructure
|
||||
that can handle the [Slashdot effect](https://en.wikipedia.org/wiki/Slashdot_effect).
|
||||
|
||||
The IOCCC had experience with people offering web mirrors and even free hosting
|
||||
only to find that the generous benefactor moves on, or their service is purchased
|
||||
by someone else who is not so generous. While it is possible that GitHub might someday
|
||||
suffer a similar fate, for the time being we are betting that GitHub will remain
|
||||
willing to host the IOCCC.
|
||||
|
||||
The [official IOCCC web site](https://www.ioccc.org) is, after all, primarily C source code
|
||||
with some supporting documentation. As such it is a natural fit for GitHub and
|
||||
[GitHub pages](https://pages.github.com).
|
||||
|
||||
|
||||
### cannot use the HTML object tag
|
||||
|
||||
The _<_ object _>_ HTML tag does not work for our needs.
|
||||
|
||||
The browser context relationship between the HTML content holds the
|
||||
HTML tag does not extend into the content that the tag includes.
|
||||
For example, menu bars will not operate as specified by the [ioccc CSS](/ioccc.css).
|
||||
|
||||
|
||||
### cannot use the HTML embed tag
|
||||
|
||||
The _<_ embed _>_ HTML tag does not work for our needs.
|
||||
|
||||
This tag wants one to specify the _width_ and _height_ in pixels.
|
||||
Use of a percentage is not officially supported even if some browsers
|
||||
might do so. Our Responsive Web Design on the [ioccc CSS](/ioccc.css)
|
||||
needs to be responsive to small-sized cell phone-like screens,
|
||||
mid-sized table-like screens, as well as large-sized desktop-like screens.
|
||||
Specifying a _width_ and _height_ in pixels will not work well in
|
||||
all of those screen size contexts.
|
||||
|
||||
|
||||
### cannot use the HTML iframe tag
|
||||
|
||||
The _<_ iframr _>_ HTML tag does not work for our needs.
|
||||
|
||||
This tag wants one to specify the _width_ and _height_ in pixels.
|
||||
Use of a percentage is not officially supported even if some browsers
|
||||
might do so. Our Responsive Web Design on the [ioccc CSS](/ioccc.css)
|
||||
needs to be responsive to small-sized cell phone-like screens,
|
||||
mid-sized table-like screens, as well as large-sized desktop-like screens.
|
||||
Specifying a _width_ and _height_ in pixels will not work well in
|
||||
all of those screen size contexts.
|
||||
|
||||
|
||||
### cannot use JavaScript to include content
|
||||
|
||||
We do not use JavaScript to include HTML content.
|
||||
|
||||
While the IOCCC may use JavaScript in the future to directly render things like C source code,
|
||||
we will do so in such a way that someone will be able to view [official IOCCC web site](https://www.ioccc.org)
|
||||
content with JavaScript disabled.
|
||||
|
||||
The IOCCC will **NOT MANDATE USE OF JavaScript** to view [official IOCCC web site](https://www.ioccc.org).
|
||||
|
||||
For this reason, we cannot use JavaScript include HTML content.
|
||||
@@ -0,0 +1,3 @@
|
||||
<!-- START: this line start content from: /inc/after-content.default.html -->
|
||||
|
||||
<!-- END: this line ends content from: /inc/after-content.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/after-rightcolumn.default.html -->
|
||||
|
||||
</div>
|
||||
|
||||
<!-- END: this line ends content from: /inc/after-rightcolumn.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/after-row.default.html -->
|
||||
|
||||
</div>
|
||||
|
||||
<!-- END: this line ends content from: /inc/after-row.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/before-content.default.html -->
|
||||
|
||||
<a name="content"></a>
|
||||
|
||||
<!-- END: this line ends content from: /inc/before-content.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/before-leftcolumn.default.html -->
|
||||
|
||||
<div class="leftcolumn">
|
||||
|
||||
<!-- END: this line ends content from: /inc/before-leftcolumn.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/before-rightcolumn.default.html -->
|
||||
|
||||
<div class="rightcolumn">
|
||||
|
||||
<!-- END: this line ends content from: /inc/before-rightcolumn.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/before-row.default.html -->
|
||||
|
||||
<div class="row">
|
||||
|
||||
<!-- END: this line ends content from: /inc/before-row.default.html -->
|
||||
@@ -0,0 +1,5 @@
|
||||
<!-- START: this line start content from: /inc/body.default.html -->
|
||||
|
||||
<body>
|
||||
|
||||
<!-- END: this line ends content from: /inc/body.default.html -->
|
||||
@@ -0,0 +1,6 @@
|
||||
<!-- START: this line start content from: /inc/bottom.default.html -->
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
<!-- END: this line ends content from: /inc/bottom.default.html -->
|
||||
@@ -0,0 +1,12 @@
|
||||
<!-- START: this line start content from: /inc/head.default.html -->
|
||||
|
||||
<head>
|
||||
<link rel="stylesheet" href="%%DOCROOT_URL_SLASH%%ioccc.css">
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||
<title>%%TITIE%%</title>
|
||||
<meta name="description" content="%%DESCRIPTION%%">
|
||||
<meta name="keywords" content="%%KEYWORDS%%">
|
||||
</head>
|
||||
|
||||
<!-- END: this line ends content from: /inc/head.default.html -->
|
||||
@@ -0,0 +1,14 @@
|
||||
<!-- START: this line start content from: /inc/page-bottom.default.html -->
|
||||
|
||||
<div class="footer">
|
||||
|
||||
<hr>
|
||||
|
||||
<h2>Footer</h2>
|
||||
|
||||
<p>This is where stuff at the bottom of all pages would be found.</p>
|
||||
|
||||
<a href="#top">Jump to top</a>
|
||||
</div>
|
||||
|
||||
<!-- END: this line ends content from: /inc/page-bottom.default.html -->
|
||||
@@ -0,0 +1,9 @@
|
||||
<!-- START: this line start content from: /inc/page-top.default.html -->
|
||||
|
||||
<div class="header">
|
||||
<img src="%%DOCROOT_URL_SLASH%%png/ioccc.png" alt="IOCCC image by Matt Zucker" width=300 height=110>
|
||||
<h1>%%HEADER_1%%</h1>
|
||||
<h2>%%HEADER_2%%</h2>
|
||||
</div>
|
||||
|
||||
<!-- END: this line ends content from: /inc/page-top.default.html -->
|
||||
@@ -0,0 +1,32 @@
|
||||
<!-- START: this line start content from: /inc/sidenav.default.html -->
|
||||
|
||||
<div class="sidenav">
|
||||
<a href="#content">Jump to contents</a>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="sidenav">
|
||||
<a href="%%DOCROOT_URL_SLASH%%index.html">IOCCC Home</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%years.html">Winning Entries</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%winners.html">People who have won</a>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="sidenav">
|
||||
<a href="%%DOCROOT_URL_SLASH%%news.html">IOCCC News</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%judges.html">The IOCCC Judges</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%contact.html">Contacting the IOCCC</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%faq.html">FAQ</a>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="sidenav">
|
||||
<a href="%%DOCROOT_URL_SLASH%%faq.html#fix_a_winner">Fixing IOCCC winners</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%faq.html#fix_web_site">Fixing the web site</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%bugs.html">Bugs & (mis)features</a>
|
||||
<a href="%%DOCROOT_URL_SLASH%%thanks-for-fixes.html">Thanks for the fixes</a>
|
||||
</div>
|
||||
<hr>
|
||||
<div class="sidenav">
|
||||
<a href="#top">Jump to top</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- END: this line ends content from: /inc/sidenav.default.html -->
|
||||
@@ -0,0 +1,11 @@
|
||||
<!DOCTYPE html>
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
||||
<!-- START: two lines up starts content from: /inc/top.default.html -->
|
||||
<!-- -->
|
||||
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
||||
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
|
||||
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
|
||||
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
|
||||
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
||||
<!-- -->
|
||||
<!-- END: this line ends content from: /inc/top.default.html -->
|
||||
@@ -0,0 +1,9 @@
|
||||
<!-- START: this line start content from: /inc/topnav.default.html -->
|
||||
|
||||
<div class="topnav">
|
||||
<a href="%%LEFT_LINK%%">← %%LEFT_TEXT%%</a>
|
||||
<a href="%%UP_LINK%%">↑ %%UP_TEXT%% ↑</a>
|
||||
<a href="%%RIGHT_LINK%%">%%RIGHT_TEXT%% →</a>
|
||||
</div>
|
||||
|
||||
<!-- END: this line ends content from: /inc/topnav.default.html -->
|
||||
Reference in new issue
Block a user