Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    Dan Allen
    @mojavelinux
    @krasv Thanks! Note that the correct place to ask questions is under #users. But since Zulip allows topics to be moved, I was able to move it there.
    pulsedrone
    @pulsedrone_gitlab
    @mojavelinux set NODE_EXTRA_CA_CERTS && antora antora-playbook.yml causes a 400 Error after npm start . How is it possible to connect to gitlab with antora.playbook.yml? i red a lot of posts, but noone had this problem before.
    pulsedrone
    @pulsedrone_gitlab
    has someone here experience how antora handles certificates in antora-playbook.yml ?
    Dan Allen
    @mojavelinux

    @pulsedrone_gitlab This is the current workaround:

    NODE_TLS_REJECT_UNAUTHORIZED=0 antora antora-playbook.yml

    As of yet, there are no dedicated configuration options for certs in Antora.

    @pulsedrone_gitlab Please join us in the new chat for this project at https://antora.zulipchat.com. We switched to Zulip because it makes it easier to manage parallel conversations because they are organized into topics.
    drykberg
    @drykberg

    @pulsedrone_gitlab If you are using self-hosted/enterprise gitlab, are using a self-signed certificate for it and running node on debian/macOS. Then it seems to me you were on the right track. All you need to do is dump the certificate chain into a .pemfile.

    NODE_EXTRA_CA_CERTS=yourCertificateChainFile.pem antora playbook.yml

    However, it looks like you are working on a Windows machine. In that case you might want to look here. I'm not a Windows expert, but I tried to help a co-worker do this on Windows and from what I remember, the Node implementation on Windows was kind of odd in that it's somehow tied to the Windows Certificate Store or something like that, making it difficult to work with self-signed certificates.

    pulsedrone
    @pulsedrone_gitlab
    Thanks @mojavelinux and @drykberg .
    Eric Weston
    @digi-brain
    Can anyone point me to a guide or tips about how to set up continuous deployment? Something that normal people (non-coders) can understand? I'm a bit new to all this, and I'm a technical writer not a developer. Currently I have the code in a private repo in GitHub, but will make it public soon; and I've FTP'd output to this location as a proof of concept: https://thehobby.zone/resources/e40k-remastered/e40k-remastered
    Even with help from a developer, we've been a bit baffled about how to set up an efficient flow; and we're completely baffled about how to set it up to take full advantage of the clever versions functionality in Antora without a lot of manual intervention to handle branches and such. Any resources that might help us please?
    Ewan Edwards
    @eskwayrd
    @digi-brain I invite you to ask your question at https://antora.zulipchat.com/. This community has switched to using Zulip and its topic-based conversation flow.
    Eric Weston
    @digi-brain
    @eskwayrd Ah, okay - I'll try that, thank you! Topic-based sounds better - I've never used Gitter before and I was a a bit baffled by the wall of comments that look like a stream of consciousness with no structure...
    Dan Allen
    @mojavelinux
    @digi-brain precisely why we switched ;)
    Eric Weston
    @digi-brain
    @mojavelinux good to know, not just me being daft then 😂
    Dan Allen
    @mojavelinux
    not at all. Trust me, we were all feeling the pain. Zulip has definitely cured our woes. (Just not COVID, unfortunately)
    Alex Volodko
    @DerXHelp
    While using PlantUML with antora there is a way to generate img tags for the images, which are then generated on-the-fly by the PlantUML server (asciidoctor-plantuml extension). Is there a way to generate static PlantUML images and simply embedd them into the page?
    With plantUML server usage there is no way to get an "offline" page
    Dan Allen
    @mojavelinux
    I see you just signed up for Zulip. We'll catch you around there!
    Imran Iqbal
    @myii
    @mojavelinux Hi, great to hear that you've moved over to Zulip. Will the GitHub/GitLab-based logins be enabled there, for both the Antora and Asciidoctor groups? I've found that really convenient to use on the various Zulip instances I've joined, so was wondering if that was in the pipeline.
    Dan Allen
    @mojavelinux
    Yes, you can use either GitLab or GitHub to register. You can find those options on the register page.
    Imran Iqbal
    @myii
    @mojavelinux Actually, that's why I was asking -- because the integration isn't actually working for both Zulip instances. It's coming back with Zulip account not found. and No account found for abc@email.com. The only options available are to log in with another account or to continue to registration.
    Maybe something under Settings/Manage organization?
    Imran Iqbal
    @myii

    Oh wow, I got caught out by the interface. You need to hit Continue to registration, which I must have forgotten from the last time I joined a Zulip instance. This reminded me: https://github.com/zulip/zulip/issues/9127#issuecomment-385125472.

    No problem here, sorry for the noise!

    Dan Allen
    @mojavelinux
    :+1:
    Olivier Jamond
    @olivier.jamond_gitlab
    Hi. I would like to slightly modify the default ui css files without creating a new ui (for example, I would like to elarge the max with of 'doc'). I tried to copy some .css files from the default ui (vars.css which looks fine for example) and modify them, but this does not work, my modification are not loaded into the site.css. I feel that there is something to do with site-extra.css, but I do not understand how this file works... Could you help me on that?
    Dan Allen
    @mojavelinux
    I invite you to ask your question at https://antora.zulipchat.com/. This community has switched to using Zulip and its topic-based conversation flow.
    Thor K. Høgås
    @thor
    @djencks have you visited the zulip instance too? :)
    Ewan Edwards
    @eskwayrd
    I haven’t seen @djencks (or @djencks_gitlab) on Zulip yet. Until the transition, he was a prolific contributor here. The timing might be coincidental, but his silence is a little concerning. I hope all is well!
    Zoran Regvart
    @zregvart
    I’m sure David is okay, there was an email exchange on the Apache Camel developers mailing list couple of days back. Sometimes it’s just a matter of priorities, so he might not have the time to chime in here or on Zulip.
    Renann Prado
    @renannprado

    Hello, everyone

    I'm trying to get typescript syntax highlight to work, but I didn't have any success. Can someone give me any hints, please?

    Here's what I've tried so far: antora/antora#711

    TL;DR: Attributes such as the below ones seem to have no effect at all.

    :source-highlighter: highlightjs
    :highlightjs-languages: typescript
    :highlightjsdir: https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@9.18.0/build

    Edit:

    Apparently one should patch the file offered in the UI bundle... that's not nice. Is there an official recommendation on how to do it?

    Ewan Edwards
    @eskwayrd
    There are two ways to customize the default UI. 1) Fork the default UI and customize it to your liking. 2) Use the supplemental_files feature to target specific file replacements in the UI.
    You can see how option two is used by investigating the docs.antora.org repo: https://gitlab.com/antora/docs.antora.org
    Either approach is “hands on”, and takes a bit of work. You have full control though.
    mbajolek
    @mbajolek

    I have Antora configured with my local kroki.io server that supports bpmn diagrams. When I try standard asciidoc notation suggested in the syntax guide:
    [bpmn]
    ....

    <bpmn xml content>
    ....

    I get xml output instead of pretty bpmn diagram.
    Is this supported by Antora?

    Ewan Edwards
    @eskwayrd
    Do you have asciidoctor-kroki installed? https://github.com/Mogztter/asciidoctor-kroki#antora-integration
    mbajolek
    @mbajolek
    yes
    plantuml works fine
    taking back my question ... Antora works well, that's Intellij plugin not recognizing [bpmn] :)
    Ewan Edwards
    @eskwayrd
    IntelliJ might not be able to run asciidoctor-kroki while it is generating the preview. AFAIK, IntelliJ doesn’t run Antora, it uses asciidoctor.js to render the preview, and is aware of the customizations that Antora applies for xrefs.
    You should probably ask about this on Zulip (where most of the community has shifted): https://antora.zulipchat.com/
    svelue
    @svelue
    Hi,
    I'm kind of confused and hope someone here may could help me.
    Currently I'm setting up an arc42 documentation based on multiple repositories using Antora. Creating HTML output works as expected, but is there a way to create PDF output and to publish to Confluence, too?
    Ewan Edwards
    @eskwayrd
    PDF generation is not built in. It is possible (with a lot of work) to use asciidoctor-pdf, or to use the experimental antora-web-pdf. The chances of encountering problems and difficulties is fairly high, and you might have to customize the code to get what you want.
    I haven’t heard of a Confluence exporter. But Antora generates a static web site, so if there’s a tool that imports HTML into Confluence, that would help.
    I’m curious to know the perceived value of importing into Confluence. Why do you want to do that?
    svelue
    @svelue
    Ok, thx, I think I've seen asciidoctor-pdf before but it exports each page as single pdf IIRC. Regarding confluence there is this: https://confluence-publisher.atlassian.net/ but from what I've read it's not working with Antora structure (includes and/or xref I think).
    Luckily for now HTML is ok for our customer. Basically the value of confluence is that it's close to all other project documentation stuff and that it's possible to make comments for "non-developers" like product management e.g.
    Ewan Edwards
    @eskwayrd
    Thanks, and good luck with your Antora conversion. Most of the community has moved over to Zulu, because it organizes conversations better. If you have more questions, ask them here: https://antora.zulipchat.com/
    *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.