diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 74683d9bcd3be97794d0092568510ef1f1836593..b3f174724585ebc12fa5e95a9ba020eaa22cdadc 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -50,9 +50,15 @@ contributions are always welcome! We use Maven to build. - mvn compile + mvn clean verify -Content is rendered into the `./target` folder in HTML, PDF, and EPUB formats. +Content is rendered into the `./target` folder in HTML, and PDF formats. + +Publishing the build currently requires some manual steps. Assuming that the `/projects` website repository is cloned at `/gitroot/www.eclipse.org/projects` (if otherwise, adjust accordingly), use the following command to build and push the result to the local copy of the website: + + mvn clean verify && cp target/generated-docs/eclipse.html /gitroot/www.eclipse.org/projects/handbook/. + +When ready to publish, use the standard Git mechanism to create a new commit and push to the `/projects` repository. The `README.md` file contains information regarding how we structure documents and other guidelines regarding content. diff --git a/source/chapters/notices.adoc b/source/chapters/notices.adoc index 68532db1b0f153f736e7252fed7c268e09998bc2..cfa6411e818c4fc5c6679710114b05a6c6ef9ec2 100644 --- a/source/chapters/notices.adoc +++ b/source/chapters/notices.adoc @@ -20,6 +20,4 @@ Copyright (C) Eclipse Foundation, Inc. and others. Made available under the {epl20Url}[Eclipse Public License v 2.0]. -This document includes content originally authored on the http://wiki.eclipse.org[Eclipsepedia wiki] by Wayne Beaton, Fabian Steeg, Denis Roy, Dave Carver, Ed Merks, Bjorn Freeman-Benson, Anne Jacko, Ian Skerrett, Mike Milinkovich, and John Arthorne. - -Version {project-version}. \ No newline at end of file +This document includes content originally authored on the http://wiki.eclipse.org[Eclipsepedia wiki] by Wayne Beaton, Fabian Steeg, Denis Roy, Dave Carver, Ed Merks, Bjorn Freeman-Benson, Anne Jacko, Ian Skerrett, Mike Milinkovich, and John Arthorne. \ No newline at end of file diff --git a/source/config.adoc b/source/config.adoc index 01fb0a0e79037b590eef653de2b849547bc9cb6d..0a49d7a25bb0810f3da8a18df04d117b8ea522c4 100644 --- a/source/config.adoc +++ b/source/config.adoc @@ -121,8 +121,6 @@ :stylesdir: ./resources :scriptsdir: ./resources -:toc: -:toc-placement: auto :icons: font :doctype: book diff --git a/source/eclipse.adoc b/source/eclipse.adoc index 53989d379ee4dfa160c00ae019d8ea336478d19a..c443055ff8e83793755c8dfba32093ed83a731d9 100644 --- a/source/eclipse.adoc +++ b/source/eclipse.adoc @@ -31,8 +31,11 @@ include::config.adoc[] :pmiSampleImage: images/pmi-egit25.png + = Eclipse Foundation Project Handbook +Current as of {localdate}. + include::chapters/notices.adoc[] include::chapters/preamble.adoc[] diff --git a/source/handbook.css b/source/handbook.css index 4c6a79f35aef4a139f64e189d0825e2e71ebd07f..7f522f374067c523d0e9b782686ae24505f6b559 100644 --- a/source/handbook.css +++ b/source/handbook.css @@ -17,6 +17,7 @@ .imageblock img { max-width: 100%; + height: auto; } #toc { border-bottom: 0 solid #dddddd; padding-bottom: 0.5em; } #toc > ul { margin-left: 0.13333em; }