Comments (4)
Alright, does this mean documents have access to variables such as ${project-artifactId} ? What's the naming convention for variables that may have a common root (such as project)? Alternatives are
- underscore as separator, e.g, project_artifactId
- dot as separator, e.g, project.artifactId
- camel case, e.g, projectArtifactId
More over, Maven proposes names such as 'groupId' and 'artifactId' where as gradle favors 'group' and 'name'. Whichever name those build tools use internally we should have a convention within asciidoctor (maven's, gradle's or our own).
from asciidoctor-gradle-plugin.
I agree we should use something that doesn't bind it to the conventions of a build tool. I'm partial to "group", "artifact" and "version", but I'd be open to "name" instead of "artifact".
The dot separator won't work in AsciiDoc since it's not a legal attribute name character. In Asciidoctor 1.5.0 or 1.6.0 we're going to make spaces, underscores and hyphens insignificant, so you can write it in whatever style you want and it will resolve to the same name.
I think internally, it makes the most sense to use a hyphen, since that is the character used by several existing built-in attributes.
- project-artifact (or project-name)
- project-group
- project-version
wdyt?
We need to sync with the Maven plugin on this too. cc: @LightGuard
from asciidoctor-gradle-plugin.
Agreed. My gut feeling says "project-name" is a much better choice 😉
from asciidoctor-gradle-plugin.
I'm leanign towards
- project-name
- project-group
- project-version
Will take this issue this week.
from asciidoctor-gradle-plugin.
Related Issues (20)
- Custom AsciidoctorTask task needs sourceDir HOT 1
- What's the way to expose "Last updated" to current time on footer tag in adoc?
- Cannot implement plugin by using task avoidance
- JavaExecSpec.main property deprecated warning and will be removed in Gradle 9.0
- Fix GEMs integration test under Windows
- Enable slides & slides-export projects
- Enable leanpub project
- Supplying closures to asciidoctorj.docExtensions causes execution issues
- Property "inProcess" is no longer available while updating to 4.0.0 HOT 3
- Can't use custom Gem (Bad file descriptor) HOT 2
- v4.0.0 compatibility issue with Java 8 HOT 8
- Invalid description in published POM HOT 5
- 4.0.x timeouts (runs out of memory?)
- Plugin includes multiple versions of the same dependency HOT 1
- Unable to use 4.0 in precompiled script plugin HOT 6
- Allow null attributes to be passed through HOT 1
- Fails to require GEMs HOT 11
- Regression with missing task dependency for additional configurations
- Gems don't work with Gradle >= 8.7 HOT 8
- Collections are not allowed HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from asciidoctor-gradle-plugin.