Seems like even Antora uses another SSG called middleman for their “marketing” home page.
https://gitlab.com/antora/antora.org If the convenience of having both content and docs all in one SSG for code maintenance is compatible with the aesthetic/ content / taxonomy strategy need for the site visitors, we’ll find out soon enough. rahul.xavier.si...@gmail.com http://cassandra.link The Apache Cassandra Knowledge Base. On Aug 21, 2020, 8:54 PM -0400, Rahul Singh , wrote: > Folks, > > I applaud the choice of Antora for documentation but I’m not sure it is the > best choice for generating an appealing site. > > Antora’s self professed strength is in technical documentation. Do we want to > stick to a “documentation” / utility look for the front facing site or for a > blog? > > https://gitlab.com/antora/antora/-/issues/444 > > I don’t want to rehash any conclusion on choosing Antora for docs or whether > asciidoc is the choice for writing documentation. > > Could we think about using something like Gatsby or similar for the front > facing 5-10 pages + blog ? E. G. Skywalking uses vuepress. > > We can use asciidoc as the common format while using Antora for the docs and > something else for the rest of the content > (https://www.gatsbyjs.com/plugins/gatsby-transformer-asciidoc/) > > Something like Gatsby can use both Markdown and Asciidoc and we can migrate > from one to the other while still using the same tooling. > > Just some thoughts would love feedback! > > rahul.xavier.si...@gmail.com > > http://cassandra.link > The Apache Cassandra Knowledge Base. > On Jul 29, 2020, 1:28 PM -0400, M Brandon Williams <dri...@gmail.com>, wrote: > > > > web