git: openjdk/amber-docs: Revise and restructure for the new web-page generator (#10)

[duke]

Changeset: b1b1c46c
Author:    Mark Reinhold <mark.reinhold at oracle.com>
Committer: GitHub <noreply at github.com>
Date:      2021-10-22 15:18:36 +0000
URL:       https://git.openjdk.java.net/amber-docs/commit/b1b1c46cde6653383df878ecc9c6160ef3cd8593

Revise and restructure for the new web-page generator (#10)

* Rename site/index.md -> site/_index.md

* Names of generated files no longer end in “.html”

* Add JEP numbers to site index

* Fix site index

* Remove JavaScript from the Text Blocks guide

* Remove extraneous paragraph elements from the Text Blocks guide

* Remove extraneous </ul> from site index

* Fix broken internal links

* Assorted markup fixes

  - Raise `<h4>`s to `<h3>`s (`s/^#### /### /`)
  - Add `{.author}` to `<h4>`s listing authors and dates
  - Use `<br>` in multi-line author blocks
  - Adjust emphasis in a few places, using blockquotes and italics
  - Use `## Sub title {.subtitle}` for subtitles
  - Use unordered lists where appropriate

* Remove redundant copy of extending-switch-for-patterns.md

* Place date information into date-classed H2 elements

* Restore historical “Data Classes” documents

* Highlight control characters in the Text Blocks guide

This change restores the JavaScript-driven highlighting of control
characters in this guide.  It also replaces the control characters
that do not exist in the Deja Vu fonts, namely

  - 2409 SYMBOL FOR HORIZONTAL TABULATION (␉)
  - 240D SYMBOL FOR CARRIAGE RETURN (␍)
  - 240A SYMBOL FOR LINE FEED (␊)

with corresponding arrow symbols that do exist in those fonts:

  - 21A6 RIGHTWARDS ARROW FROM BAR (↦)
  - 2190 LEFTWARDS ARROW (←)
  - 2193 DOWNWARDS ARROW (↓)

* Add missing documents to the index page

* Capitalize titles consistently

* Define short anchors for FAQ and guideline items

* Text blocks guide: Add table of contents

* Text blocks guide: Shift position of table of contents

* Extending switch for Patterns: Expose inherent list structure

* Remove old publication infrastructure

* Update .gitignore

* Create symbolic link to ojweb-generate/Makefile

* Restructure templated-strings.md, and add it to the project page

* Further minor layout tweaks

* Use a real Makefile instead of a symbolic link

Skara doesn’t (yet) like symbolic links.

* Drop execute bits on text files

- .github/workflows/publish.yaml
! .gitignore
- .nojeckyll
! Makefile
! eg-drafts/deconstruction-patterns-records-and-classes.md
! eg-drafts/reconstruction-records-and-classes.md
- etc/footer.html
- etc/style.css
+ site/_index.md
! site/design-notes/constables.md
! site/design-notes/data-classes-historical-1.html
! site/design-notes/data-classes-historical-2.html
- site/design-notes/extending-switch-for-patterns.md
! site/design-notes/patterns/extending-switch-for-patterns.md
! site/design-notes/patterns/pattern-match-object-model.md
! site/design-notes/patterns/pattern-match-semantics.md
! site/design-notes/patterns/pattern-match-translation.md
! site/design-notes/patterns/pattern-matching-for-java.md
! site/design-notes/patterns/type-patterns-in-switch.md
! site/design-notes/records-and-sealed-classes.md
! site/design-notes/templated-strings.md
! site/design-notes/towards-better-serialization.md
! site/guides/lvti-faq.md
! site/guides/lvti-style-guide.md
+ site/guides/text-blocks-guide.head
! site/guides/text-blocks-guide.md
- site/index.md