antora/users

The official chat room for Antora is now located at https://antora.zulipchat.com. Please join us there!

Ewan Edwards

@eskwayrd

*Zulip (I’m on my phone)

svelue

@svelue

Thx, good to know :)

Dan Allen

@mojavelinux

@svelue I'd be happy to follow up with your question in Zulip (so that others can benefit from the conversation too).

Jayesh Jain

@jjcool

Hi @eveyone, I am trying to build my antora site on my azure pipeline(hosted in the repo itself), I am getting error of "Content repository not found or requires credentials". I know I need to pass .git-credentials file for it. Dont know how to do it though

Dan Allen

@mojavelinux

I'd be happy to answer your question at https://antora.zulipchat.com.

kannankuppi

@kannankuppi

Hi @everyone, Where to find the release version of the default UI bundle? https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/master/raw/build/ui-bundle.zip?job=bundle-stable

Joseph Cayouette

@jcayouette

Evening, you may be interested in checking out our latest SUMA release which includes translations of several of our books "more coming". Big thanks to Pau Garcia Quiles for his translation knowledge and experience. https://documentation.suse.com/en-us/suma/4.2/ This process uses a few "hacks", but may provide some insight. It works very well once all the bolts are in place. Repo located here: https://github.com/uyuni-project/uyuni-docs And hello :) I realize I have not been around recently.

Dan Allen

@mojavelinux

:wave: @jcayouette. We've all moved over to https://antora.zulipchat.com. I encourage you to join us there.

Joseph Cayouette

@jcayouette

Ah thanks :D I see that now.

Dan Allen

@mojavelinux

We're having a good old time there :confetti_ball:

Joseph Cayouette

@jcayouette

Cool looks good.

Dan Allen

@mojavelinux

@kannankuppi Please ask your question in https://antora.zulipchat.com.

Marcel Widmer

@marzelwidmer

Hello I try to generate plantuml on the fly with antora we have already production documentation where we used something like : plantuml::_images/_Usecase.puml[png] I am not sure if this the way to go https://github.com/Mogztter/asciidoctor-kroki#antora-integration I try it to configure on in the site.yaml but I get some JS exeptions...
My configuration looks like :

site:
  title: "Antora Docs"
  url: https://marzelwidmer.github.io.
  start_page: component-a::index
  robots: allow

git:
  ensure_git_suffix: false

content:
  branches: master
  sources:
#  - url: https://github.com/marzelwidmer/antora-component-a.git
  - url: ./../antora-component-a
ui:
  bundle:
    url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/master/raw/build/ui-bundle.zip?job=bundle-stable
    snapshot: true
  output_dir: ui-bundle
  supplemental_files: ./supplemental-ui

output:
  dir: ./public

asciidoc:
  extensions:
    - asciidoctor-kroki

However, in Antora, this is not currently compatible with inline SVG images. get it correctly that this is not supported what I need...

4 replies

Cyrille Chopelet

@cyChop_gitlab

Hi,
I've been an AsciiDoctor fan for a decade and I know discover Antora, which is wonderful.

I'm migrating my Maven-generated documentation to Antora, but there are a few things I have difficulty with, especially with diagrams/PlantUML. I can generate and fetch them, but I couldn't find how to:

use a config file for all plantuml (tried setting asciidoc.attributes.plantuml-config, but it seems not to work)
use the inline or interactive type for svg diagrams (tried setting asciidoc.attributes.plantuml-svg-type, diagram-svg-type, tried setting it on the diagram itself, but I always get an image tag).

Am I trying to do things that are not possible yet, or am I just going at it the wrong way? Thanks!

Cyrille Chopelet

@cyChop_gitlab

(Just saw about the moving to Zulip, will take my question there.)

Chris Cranford

@Naros

Hi all, we currently define our playbook as follows:

site:
  title: Debezium Documentation
  url: https://www.debezium.io/documentation
content:
  sources:
    - url: https://github.com/debezium/debezium.git
      start_path: documentation
      branches:
        - '1.6'
        - '1.7'
        - 'master'

This obviously leads to master being published to /documentation/reference and then having /documentation/reference/1.7 and /documentation/reference/1.6.
I'm wondering if there is a way to change this behavior somewhat so that we would actually publish branch master to /documentation/reference/dev and then publish branch 1.6 to /documentation/reference/stable.
Can this be done in one playbook or would multiple playbooks be required for this?

Ewan Edwards

@eskwayrd

Can you ask your question on Zulip?

Chris Cranford

@Naros

I did already and found my answer, sorry I didn't see the room message until after I posted my question @eskwayrd

Colm O'Shea

@colmose

Hi, have a question about redirects. Is there a way of redirecting to the latest docs and then to a page within those docs? e.g rather than landing on the index.html and being redirected to "v1.2.3/index.html", redirecting to "v1.2.3/my/nested/page.html" from "<something>/my/nested/page.html"?

Dan Allen

@mojavelinux

The community chat has been migrated to https://antora.zulipchat.com. Please join us there. This room is only meant for archival purposes.

abyshukla

@abyshukla

configuration param 'ui.bundle.url' missing from config

my playbook

site:
    title: Docs
content:
    sources:
        - url: https://github.com/abyshukla/antora-sandbox.git
          branches: [master, tinkerings]
ui:
    bundle:
        url:./../antora-ui/build/ui-bundle.zip

Dan Allen

@mojavelinux

The community chat has been migrated to https://antora.zulipchat.com. Please join us there. This room is only meant for archival purposes.

Padma vati

@epadmavati_gitlab

Please help to rectify this error: configuration param 'ui.bundle.supplemental_files' not declared in the schema

James Elliott

@brunchboy

The community chat has migrated to https://antora.zulipchat.com. Please join us there. This room is only being kept for archival purposes.

Padma vati

@epadmavati_gitlab

How to put images in ui page in antora-ui-default

I integrate antora-lunr into my antora-ui-default but supplimental headerfile i got that is not my purpose i want search engine in my ui-default

plz tell me how to integrate lunr into my ui-default page i only want serach engine

Dan Allen

@mojavelinux

Please respect our request and direct your questions to https://antora.zulipchat.com.

Padma vati

@epadmavati_gitlab

In antora how to conents in left side to right side toc

please help me

Padma vati

@epadmavati_gitlab

I cna't understand zulip

James Elliott

@brunchboy

Unfortunately, Zulip is where the community has moved. It provides much better ways to organize and refer to responses, and the people who can help you are focusing their energy on that site. Perhaps we can help you with Zulip? What are you having problems with? I think the process of creating an account there is similar to here, although you also have the option of logging in using more services’ username/password if you already have any set up.

Mona Bärenfänger

@Tschakki

Hi, I am playing around with the glossary plugin: https://gitlab.com/djencks/asciidoctor-glossary - I really like it and would like to use it in our docs :) The problem is, I have some links in the explanation of specific glossary terms, and the plugins seems to have problems with that. Is there maybe a trick to add links correctly to the glossary term? @djencks_gitlab :pray:

ah, I just read about zulip xD Will ask there as well :+1:

Etienne Mann

@EtienneMann_twitter

Dear all,
I wrote a website using antora https://gdrsingularites.math.univ-angers.fr/GDR%20Singularit%C3%A9s%20et%20Applications/1/index.html
But in the toolbar on a firefox, it is written "Untitled::GDR..." how is it possible to change this Untitled ?

Dan Allen

@mojavelinux

The project chat has moved to https://antora.zulipchat.com. Please ask your question there. See https://docs.antora.org/antora/3.0/project/get-help/#chat

Josef

@tbugfinder

Hi, my antora (2 or 3) generated site has a „Components“ dropdown at top right next to Home. Unfortunately it’s empty and I don’t understand why. I also cannot figure out how to hide it. Secondly I tried Antora3 with the new Lunr search ext. Unfortunately the search box doesn’t show up in site header. Any suggestions ?

Oh, will move to zulip

Zulip, got it

Dan Allen

@mojavelinux

:+1:

Josef

@tbugfinder

It doesn’t like my registration through gh 😏

James Elliott

@brunchboy

I saw that happen on my own Zulip, saying the link had expired, but people reported being able to sign up using their email address.

Dan Allen

@mojavelinux

It's usually better to use that approach since there is no reason to link them...best to start fresh.

Alice Liu

@aliceliudoc

I was building the project. Always get an error " antora.yml not found

Ewan Edwards

@eskwayrd

Hi Alice. If you scroll up a bit, you’ll see that the Antora chat has moved to Zulip. Please ask your question there, and be prepared to provide more detail, such as the actual command you’re using, where your antora.yml file is, and what OS you are using.

Where communities thrive

People

Repo info

Activity