Because many Spring projects will have both single and multi page
reference docs variants, we should only show "back to index" links on
pages that aren't already index pages.
This commit adds the CI infrastructure for running builds with
Concourse. This includes:
* a docker image for the CI image (JDK 8 based)
* a set of Concourse pipelines for building, staging and promoting
artifacts
In b19bb45, the artifact coordinates were changed to
"io.spring.docresources:spring-doc-resources".
We can set now a new version for the project initial release.
Prior to this commit, generated Asciidoctor theme files were directly
committed in this project as static files.
This commit removes those files and instead builds on SASS files, just
like other Asciidoctor themes are generated (see
https://github.com/asciidoctor/asciidoctor-stylesheet-factory).
This commit also reorganizes the build to use a Gulp + NPM based build
for generating and optimizing those static resources before packaging
them.
Note that this change is resetting the whole Spring theme to a basic CSS
stylesheet - further commits are expected to get back to a proper theme.
Somehow, I built the previous instance of the zip file such that it wasn't really a zip file. This time, I used the git archive command. Then I tested it with Mac's unzip command. It worked.
I made some changes (to get the Back to Index link in the dynamic ToC to work for more cases and to have sensible IDs), so I need to commit the zip file again.
I refined the ability of the script that handles the table of contents to detect whether it should have a "Back to Index" link. The previous logic of checking the file name for whether it was index.html doesn't cover cases where the book is renamed, as Spring Data does with its books. So I added a check for the documet type. A type of "book" indicates a stand-alone document, which shouldn't have hthe link.
I built the zip file and added it to the Github repository. I also added more detail about how to use the files to README.md (per a request from Oliver Gierke).
I re-organized the content to match Maven's usual organization. Then I built a pom.xml file and an assembly file (dep.xml) so that Maven will build a zip file of these resources. The zip file ends up in the /target directory.
Damien Vitrac
Brian Clozel
Jay Bryant