tinkerpop/tinkerpop3 — pull request #14 by dalaro (2014-05-28 18:07:55+00:00)
Title: Deploy AsciiDoctor output to S3 and prevent line wrapping in the docs' code blocks

86ac939e5a5ee51f88401aed4df9abad00924a31 uploads AsciiDoctor output to an S3 bucket during the deploy phase of the Maven lifecycle when the asciidoc profile is enabled. `mvn deploy -Dasciidoc` will upload docs to S3. Disabling the `asciidoc` profile or running an earlier lifecycle stage than `deploy` will not upload docs to S3. So `mvn deploy` and `mvn install -Dasciidoc` won't upload.

In particular, `target/docs/htmlsingle/` gets uploaded to `s3://www.tinkerpop.com/docs/tinkerpop3/${project.version}`. The directory need not exist, but the bucket (www.tinkerpop.com) should exist.

Repeatedly deploying/uploading docs with the same project version will overwrite the existing files in S3. I don't think it deletes files that are no longer used, though I haven't checked. Anyway, if you want to have an exact mirror in S3 after deleting or renaming files, I wouldn't rely on the wagon; it's probably better in that case to delete the directory in S3 that corresponds to docs for that version (e.g. `docs/tinkerpop3/3.0.0-SNAPSHOT/`) before redeploying/reuploading.

9ad6ca281b54ccd3143ee6a5a26a515ff3b4a085 responds to Marko's recent message about line wrapping in AsciiDoctor-generated code blocks. I forked AsciiDoctor's readthedocs theme as a new theme called tinkerpop, then disabled line wrapping in favor of automatically adding horizontal scrollbars to code listings containing lines too wide for the enclosing element. `tinkerpop.scss` is the source file; `tinkerpop.css` is the output generated by asciidoctor-stylesheet-factory from the associated `.scss` when I ran `compass compile`.

Here's sample output uploaded using the new Maven pom bits and containing the stylesheet tweak:

http://www.tinkerpop.com/docs/tinkerpop3/3.0.0-SNAPSHOT/