Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    Dan Allen
    @mojavelinux
    trying our best to stay a step ahead ;)
    Pi3r
    @PierreR
    Hi
    How is the right side menu generated for instance here: https://lisk.io/documentation/lisk-sdk/lisk-commander/user-guide.html
    Is this a new feature that requires a recent version of antora ?
    This doc website is awesome by the way.
    Chris Cranford
    @Naros
    I have not looked at the new UI aspects @PierreR, but you can accomplish that even with older releases. What we did at https://debezium.io/documentation/reference/1.0/ was basically add some custom CSS styles that repositions the toc on the right side.
    We simply use the default-ui with some supplemental overrides and additional css definitions.
    I haven't yet looked at the 2.3 change log, but if that's coming, that'll be a nice addition as well.
    Dan Allen
    @mojavelinux
    @PierreR if it's like the open MR in Antora, it's jut done using JavaScript. It reads the headings on the page and populates the sidebar.
    Both Couchbase and MuleSoft do it too. It's very little code. See https://github.com/couchbase/docs-ui/blob/master/src/js/02-on-this-page.js Once 2.3 is out, I'll get that merged into the UI
    Dan Allen
    @mojavelinux
    @Naros I don't see debezium on the showcase issue yet. feel free to add it here: antora/antora.org#20
    Chris Cranford
    @Naros
    @mojavelinux I'll mention it to Gunnar when we're all back from the holiday break and if he's fine with it, I'll add it.
    Dan Allen
    @mojavelinux
    :+1:
    in 2020, we will get that website up so that you'll be in the gallery.
    good way to promote both projects ;)
    Chris Cranford
    @Naros
    +1
    Hopefully soon I can get to adding a bit more color to our documentation so that its less white/black/grey :)
    Dan Allen
    @mojavelinux
    I could say the same about the Antora docs
    danyill
    @danyill
    Just updated some of the sites on the showcase. Hey this openZeppelin site is really sweet
    Dan Allen
    @mojavelinux
    that IS really nice
    looks like the adopted the version selector from MuleSoft. https://docs.openzeppelin.com/sdk/2.6/
    ;)
    word must get around in Buenos Aires
    there are a few more things still to wrap up for 2.3, but we're well on our way to having it out. I may slightly change how the built-in resolvePage helper works to return a page model instead of a file. and I'm hoping to get supplemental worktrees in too, though there are some open questions about it still to address.
    from there, we'll be looking towards 3.0
    danyill
    @danyill
    I opened an issue about editor tooling for Antora. It'd be good to see some thoughts on what people would like to see. antora/antora#540
    Dan Allen
    @mojavelinux
    I agree. And that's a fine place for it as an architecture / requirements discussion.
    Josef
    @tbugfinder
    Hi, I'm wondering if there's a repo with different antora UI styles available?
    danyill
    @danyill
    @tbugfinder not as such but there's quite a few open source UIs listed here antora/antora.org#20
    Mark
    @scitechcs
    Having a right-side on-page table of contents is a nice feature for longer topics. There are a couple of considerations: (1) Use a script and CSS combination that highlights the section you are viewing, (2) Add a script that creates a vertical scroll offset when you click one of the on-page TOC links. With the script I use, clicking one of these links leaves the target heading hidden behind the top banner and you have to scroll down for the heading to appear. A second script is needed to create a vertical scroll offset so the heading is visible after clicking the link.
    Mark
    @scitechcs
    I posted a screenshot of my Antora implementation (with product names blurred out) so you can see the on-page navigation. The on-page navigation highlight doesn't exactly match the section being viewed because of the javascript scroll offset, but it's close.
    capture.png
    Josef
    @tbugfinder
    Hi @scitechcs, which search option did you integrate?
    Dan Allen
    @mojavelinux
    @scitechcs what you are showing (which looks good) is what will be added to the default UI. I just haven't had time to review and merge it yet. I'll do it shortly after the 2.3 release is ready.
    Mark
    @scitechcs
    I used the JavaScript version of the Zoom search engine. My site is installed as a help system along with software on a local computer, so I have to use a client side search engine. I think it's a good search engine. I like the Google style results page that uses the description attribute from the asciidoc pages.
    It will be great to have the on-page navigation included by default.
    Dan Allen
    @mojavelinux
    @scitechcs totally agree
    David Jencks
    @djencks_gitlab
    I'm wondering if there's a way or conceptual model to have a site (or component) with individually versioned pages. I'm thinking of something like Guillaume's "blog antora" https://github.com/yuzutech/blog.yuzutech.fr except where you can go to old versions of each post. Perhaps one starting point would be to spread out the git versions of a page into separate content catalog entries, or even to preprocess the git repo to duplicate page versions into separate files.
    Dan Allen
    @mojavelinux
    we specifically designed Antora to not address that case. We felt it would be overengineered if we did and too hard for anyone to understand. In theory, it could be done since the content catalog is all virtual. But that won't be our focus.
    Dan Allen
    @mojavelinux
    Happy Holidays everyone! Thank you all for your involvement in the project this past year. I'm excited about what's to come in the new year! We'll keep growing and growing, and continue to work hard to make documentation awesome. :tada:
    David Jencks
    @djencks_gitlab
    @mojavelinux Happy Holidays! I wasn't thinking Antora ought to support individually versioned files out of the box, but rather wondering if anyone had an idea how to get it to work as a modification.... it's a use case I'd find useful and there have been some other people seemingly wanting to try something similar. Although iso-git doesn't appear to support notes directly, I'm thinking writing the "page version" in a note attached to a file might work for the data model, and modifying the content aggregator to look in history for the notes might work for the implementation.
    Dan Allen
    @mojavelinux
    ...and we're back! Gitter seems to have been down most of the day.
    I realized today that one of the nice benefits of exposing the content catalog to the UI (via site.contentCatalog), is that you could, in theory, create a helper to autogenerate navigation based on your own system. (It's still possible to do it with a custom generator too, but the UI template / helper approach is a more of a soft handed approach.
    Matthew Setter
    @settermjd
    Hey folks, I’ve been reading through the include directive documentation, but don’t quite understand how to set attributes when using it. Can someone point me in the right direction?
    Matthew Setter
    @settermjd
    Sorry, wrong channel. Will ask in asciidoctor/asciidoctor
    Dan Allen
    @mojavelinux
    @settermjd you can't set document attributes using an include directive. You have to set them around the include directive.
    the attributes on the include directive pertain to configuring the include itself
    leveloffset is exception, and was only added because it is used so frequently. but all that does is set document attributes around the include (implicitly)
    Ulf Riehm
    @ukubauka
    Ok, first: Happy Christmas.
    2nd. We have a 1000 page asciidoc manual collection, which is humming around real world machines, in other words, not software primarily. Its in a repo on bitbucket. We currently use it to create pdf, but now would ALSO create a website from it which the machines can retrieve and display online on their HMI. While currently all the nice document settings are working ok, as every document does inlcude the corresponding partial, that doesnt seem to work the same way when antora creates a website. Yes, we could rearrange all the settings and make them global in the playbook, but then how would we keep creating flawless pdf? Is there a way we can create common settings valid for both outputs?
    Ulf Riehm
    @ukubauka
    3rd. Thanks for asciidoc and antora.