[ 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 8/7/21, 11:29 AM: -------------------------------------------------------------------------- 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} # push to staging, after having built with antora git switch asf-staging # 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 git add content git commit content git push origin asf-staging {code} The {{.htaccess}} addition is {code} RedirectMatch 301 "^/$" "/_/index.html" RewriteCond %{REQUEST_URI} !^/doc/.* RewriteCond %{REQUEST_URI} ^(.*)/$ RewriteRule ^(.*)/$ /_/$1.html [R=301,L] # redirects to new antora in-tree docs RewriteCond %{REQUEST_URI} !^/doc/latest/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/latest/cassandra [NC] RewriteRule ^/?doc/latest/(.+)$ /doc/latest/cassandra/$1 [R=301,L] RewriteCond %{REQUEST_URI} !^/doc/stable/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/stable/cassandra [NC] RewriteRule ^/?doc/stable/(.+)$ /doc/stable/cassandra/$1 [R=301,L] RewriteCond %{REQUEST_URI} !^/doc/4.0/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/4.0/cassandra [NC] RewriteRule ^/?doc/4.0/(.+)$ /doc/4.0/cassandra/$1 [R=301,L] RewriteCond %{REQUEST_URI} !^/doc/3.11/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/3.11/cassandra [NC] RewriteRule ^/?doc/3.11/(.+)$ /doc/3.11/cassandra/$1 [R=301,L] {code} was (Author: michaelsembwever): 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} The {{.htaccess}} addition is {code} RedirectMatch 301 "^/$" "/_/index.html" RewriteCond %{REQUEST_URI} !^/doc/.* RewriteCond %{REQUEST_URI} ^(.*)/$ RewriteRule ^(.*)/$ /_/$1.html [R=301,L] # redirects to new antora in-tree docs RewriteCond %{REQUEST_URI} !^/doc/latest/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/latest/cassandra [NC] RewriteRule ^/?doc/latest/(.+)$ /doc/latest/cassandra/$1 [R=301,L] RewriteCond %{REQUEST_URI} !^/doc/stable/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/stable/cassandra [NC] RewriteRule ^/?doc/stable/(.+)$ /doc/stable/cassandra/$1 [R=301,L] RewriteCond %{REQUEST_URI} !^/doc/4.0/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/4.0/cassandra [NC] RewriteRule ^/?doc/4.0/(.+)$ /doc/4.0/cassandra/$1 [R=301,L] RewriteCond %{REQUEST_URI} !^/doc/3.11/index.html [NC] RewriteCond %{REQUEST_URI} !^/doc/3.11/cassandra [NC] RewriteRule ^/?doc/3.11/(.+)$ /doc/3.11/cassandra/$1 [R=301,L] {code} > 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-unsubscr...@cassandra.apache.org For additional commands, e-mail: commits-h...@cassandra.apache.org