[jira] [Comment Edited] (CASSANDRA-16761) New Cassandra Website and Documentation

["Michael Semb Wever (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CASSANDRA-16761?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17380763#comment-17380763 ] 

Michael Semb Wever edited comment on CASSANDRA-16761 at 7/14/21, 5:36 PM:
--------------------------------------------------------------------------

the antora built version of the new website design is on staging: https://cassandra.staged.apache.org/


following manual steps were required, after the antora generation…
{code}
# copy everything to content/ directory
cp -r site-content/build/html/* content/

# update the .htaccess file
nano content/.htaccess

# remove hardcoded domain name
for f in $(rg -l "https://cassandra.apache.org/" content/_) ; do sed -i '' 's/https:\/\/cassandra.apache.org\//\//g' $f ; done
{code}


was (Author: michaelsembwever):
the antora built version of the new website design is on staging: https://cassandra.staged.apache.org/


> New Cassandra Website and Documentation
> ---------------------------------------
>
>                 Key: CASSANDRA-16761
>                 URL: https://issues.apache.org/jira/browse/CASSANDRA-16761
>             Project: Cassandra
>          Issue Type: Epic
>          Components: Documentation/Website
>            Reporter: Anthony Grasso
>            Assignee: Anthony Grasso
>            Priority: High
>             Fix For: 4.0.x
>
>
> This epic captures the work associated with the development of the new Cassandra website and documentation.
> Work to create the new website and documentation will be broken up as follows:
>  * Proof of concept - CASSANDRA-16029
>  * Website concept and design - CASSANDRA-16115
>  * Develop tooling to render new website and documentation - CASSANDRA-16066
>  * Create website content that will be rendered by new tooling - CASSANDRA-16762
>  * Create Cassandra documentation content that will be rendered by new tooling - CASSANDRA-16763
> It is expected that the new website and documentation will be in asciidoc format and rendered using Antora.
> Antora is purpose built for rendering versioned documentation to HTML. In addition it allows rendering customisations via Java Script which may be useful when rending the website.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org