Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Uses the Asciidoctor GhPages Action to automatically build the README.adoc to HTML, enabling GitHub Pages for the project. #3

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions .github/workflows/asciidoctor-ghpages.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
name: asciidoctor-ghpages

# Controls when the action will run. Triggers the workflow on push or pull request
# events but only for the master branch
on:
push:
branches: [ master ]
pull_request:
branches: [ master ]

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
# This workflow contains a single job called "build"
build:
# The type of runner that the job will run on
runs-on: ubuntu-latest

# Steps represent a sequence of tasks that will be executed as part of the job
steps:
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
- uses: actions/checkout@v2

- name: asciidoctor-ghpages
uses: manoelcampos/[email protected]
with:
asciidoctor_params: --attribute=nofooter
Empty file modified .gitignore
100644 → 100755
Empty file.
Empty file modified .travis.yml
100644 → 100755
Empty file.
Empty file modified LICENSE
100644 → 100755
Empty file.
Empty file modified NOTICE
100644 → 100755
Empty file.
6 changes: 3 additions & 3 deletions README.adoc
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
image:https://travis-ci.org/johncarl81/exportdoclet.svg?branch=master["Build Status", link="https://travis-ci.org/johncarl81/exportdoclet"]

A link:http://docs.oracle.com/javase/1.5.0/docs/guide/javadoc/doclet/overview.html[Doclet] that allows exporting javadoc
comments containing link:http://asciidoctor.org[AsciiDoc] text to AsciiDoc files, enabling combining the javadocs into a broader AsciiDoc documentation for your Java project.
comments containing link:http://asciidoctor.org[AsciiDoc] markup to AsciiDoc files, enabling combining the javadocs into a broader AsciiDoc documentation for your Java project.

Instead of exporting the javadoc comments to standard HTML files, the ExportDoclet exports them to AsciiDoc files, that in turn can be converted to any output format supported by the link:http://asciidoctor.org[AsciiDoctor toolchain].

Expand All @@ -15,12 +15,12 @@ ExportDoclet encourages developers to write meaninguful and expanded documentati

== Building the ExportDoclet

ExportDoclet is a Java Maven project that can be built directly from any IDE or using the following maven command:
ExportDoclet is a Java Maven project which can be built directly from any IDE or using the following maven command:

[source,bash]
mvn clean install

That will build the tool and install it at your local maven repository, usually at the .m2 directory
That will build the tool and install it at your local maven repository, usually at the `.m2` directory
inside your home directory.

== How to use ExportDoclet
Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>17.0</version>
<version>26.0-jre</version>
</dependency>
<dependency>
<groupId>junit</groupId>
Expand Down
Empty file modified sample/pom.xml
100644 → 100755
Empty file.
Empty file modified sample/src/main/java/people/Person.java
100644 → 100755
Empty file.
Empty file modified sample/src/main/java/vehicles/AbstractVehicle.java
100644 → 100755
Empty file.
Empty file modified sample/src/main/java/vehicles/Car.java
100644 → 100755
Empty file.
Empty file modified sample/src/main/java/vehicles/Vehicle.java
100644 → 100755
Empty file.
4 changes: 2 additions & 2 deletions src/main/java/org/asciidoctor/ExportDoclet.java
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ public class ExportDoclet extends Doclet {
* Starts the doclet.
* @param rootDoc the root of the program structure information.
* From this root all other program structure information can be extracted.
* @return true if the doclet was started successfuly, false otherwise
* @return true if the doclet was started successfully, false otherwise
* @see Doclet#start(RootDoc)
*/
@SuppressWarnings("UnusedDeclaration")
Expand Down Expand Up @@ -96,4 +96,4 @@ public static LanguageVersion languageVersion() {
private boolean render(){
return renderer.render();
}
}
}
Empty file modified src/main/java/org/asciidoctor/ExportRenderer.java
100644 → 100755
Empty file.
Empty file modified src/main/java/org/asciidoctor/StandardAdapter.java
100644 → 100755
Empty file.
Empty file modified src/main/java/org/asciidoctor/package-info.java
100644 → 100755
Empty file.