Fallback versions not supported

Observed vs. expected behavior

The plugin does not seem to support Fallback Versions (an antora 3.x feature, far as I can tell).

FWIW: The plugin documentation doesn’t indicate exclusive support of antora 2.x, so I’m creating this as a bug. Apologies if you consider it a feature request instead.

Steps to reproduce

Setup according to the docs (green builds on my end, too):

# antora.yml
name: my-module
# version: main # NB: Unversioned, cf. including playbook

title: My Module
start_page: ROOT:index.adoc
nav:
  - modules/ROOT/nav.adoc

# antora-playbook.yml
site:
  title: My Website
  start_page: my-module:ROOT:index.adoc
content:
  sources:
  - url: https://some.server/my-module.git
    branches: main
    version: ~  # aka unversioned
    start_path: docs

# /snip

Expected: Green files, syntax completion.

Actual:

• content.sources[].version in antora-playbook.yml not supported:
  
• version in antora.yml required:
  

FWIW, refname projection probably requires additional consideration.

Environment

Plugin Version: 0.37.43

PyCharm 2022.2.1 (Professional Edition) Build #PY-222.3739.56, built on August 16, 2022 Runtime version: 17.0.3+7-b469.37 amd64 VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o. Linux 5.15.0-43-generic GC: G1 Young Generation, G1 Old Generation Memory: 2500M Cores: 8 Registry: debugger.click.disable.breakpoints=true

Non-Bundled Plugins: org.nik.presentation-assistant (1.0.10) org.jetbrains.plugins.go-template (222.3739.24) name.kropp.intellij.makefile (222.3739.24) com.intellij.plugins.macoskeymap (222.3739.24) com.intellij.ideolog (203.0.30.0) com.github.mikesafonov.jenkins-linter-idea-plugin (0.6.0) com.dmarcotte.handlebars (222.3739.24) Key Promoter X (2022.2) org.sonarlint.idea (7.0.0.52289) org.asciidoctor.intellij.asciidoc (0.37.43) ir.msdehghan.plugins.ansible (0.92) ru.meanmail.plugin.requirements (2022.3-222-EAP-SNAPSHOT) net.ashald.envfile (3.2.2) com.intellij.kubernetes (222.3739.24)

Current Desktop: i3

[mojavelinux]

Not sure if that is really useful. I’d argue that IDE support will be better if you set it to an actual version in the component descriptor (or ~ for versionless ones).

Trust me when I say it’s extremely useful. We wouldn’t have developed it otherwise. Every since the very first version of Antora, we have been asked to allow the version to be derived from the refname (either an exact match or extracted from it). This saves users from having to duplicate this information. It’s true that not everyone will take advantage of it. But for those who do, it’s probably the only thing they will use.

[ahus1]

Thanks for creating this issue and the pull request. The plugin supports Antora 3.x,so this is a bug.

The current version of the plugin would support it by setting version: ~ in the component version descriptor. This would then make it clear for someone looking only at the component that it is versionless.

Expect a new pre-release that includes your PR later this week.