From commits-return-218220-archive-asf-public=cust-asf.ponee.io@cassandra.apache.org Wed Jan 9 07:40:05 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 310B3180676 for ; Wed, 9 Jan 2019 07:40:05 +0100 (CET) Received: (qmail 1701 invoked by uid 500); 9 Jan 2019 06:40:04 -0000 Mailing-List: contact commits-help@cassandra.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cassandra.apache.org Delivered-To: mailing list commits@cassandra.apache.org Received: (qmail 1689 invoked by uid 99); 9 Jan 2019 06:40:04 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 09 Jan 2019 06:40:04 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id BFCAAC7EC7 for ; Wed, 9 Jan 2019 06:40:03 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -109.501 X-Spam-Level: X-Spam-Status: No, score=-109.501 tagged_above=-999 required=6.31 tests=[ENV_AND_HDR_SPF_MATCH=-0.5, KAM_ASCII_DIVIDERS=0.8, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, USER_IN_DEF_SPF_WL=-7.5, USER_IN_WHITELIST=-100] autolearn=disabled Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id C_sWJsfAOZal for ; Wed, 9 Jan 2019 06:40:02 +0000 (UTC) Received: from mailrelay1-us-west.apache.org (mailrelay1-us-west.apache.org [209.188.14.139]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with ESMTP id 6C6E55F52F for ; Wed, 9 Jan 2019 06:40:01 +0000 (UTC) Received: from jira-lw-us.apache.org (unknown [207.244.88.139]) by mailrelay1-us-west.apache.org (ASF Mail Server at mailrelay1-us-west.apache.org) with ESMTP id 9CD3EE2642 for ; Wed, 9 Jan 2019 06:40:00 +0000 (UTC) Received: from jira-lw-us.apache.org (localhost [127.0.0.1]) by jira-lw-us.apache.org (ASF Mail Server at jira-lw-us.apache.org) with ESMTP id 5F2C02556C for ; Wed, 9 Jan 2019 06:40:00 +0000 (UTC) Date: Wed, 9 Jan 2019 06:40:00 +0000 (UTC) From: "Anthony Grasso (JIRA)" To: commits@cassandra.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Comment Edited] (CASSANDRA-14972) Provide a script or method to generate the entire website at the push of a button MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ https://issues.apache.org/jira/browse/CASSANDRA-14972?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16737893#comment-16737893 ] Anthony Grasso edited comment on CASSANDRA-14972 at 1/9/19 6:39 AM: -------------------------------------------------------------------- The steps involved to generate the entire website from scratch are # SVN checkout - [https://svn.apache.org/repos/asf/cassandra/site|https://svn.apache.org/repos/asf/cassandra/site] # Git clone Cassandra - [git@github.com:apache/cassandra.git|https://github.com/apache/cassandra] # Set the environment variable {{CASSANDRA_DIR}} to point to the SVN Cassandra checkout location # Install *Ruby 2.3.x* and *Make* for building the website # Install *Java 1.8.x*, *Ant*, *Maven*, *Python 2.7.x*, and *Python Sphinx* for generating the Cassandra docs # From the SVN Cassandra checkout install *Jekyll* - {{gem install bundler && bundle install}} # From the SVN Cassandra checkout _src_ directory run {{make add-doc}} to make the docs for latest # From the Git Cassandra checkout change to branch {{cassandra-3.11}} - {{git checkout cassandra-3.11}} # From the SVN Cassandra checkout _src_ directory run {{make add-doc}} again to make the docs for 3.11 # From the SVN Cassandra checkout _src_ directory run {{make}} to build the website Probably the easiest way to do this is to have a Docker contain which installs all the tools required to build the docs and the site. Inside of the container have an entry point script which performs the tasks to generate the docs and the site. This is my first take on it. These files are to be placed in the _svn.apache.org/repos/asf/cassandra/site_ directory. * [^docker-compose.yml] * [^docker-entrypoint.sh] * [^Dockerfile] was (Author: anthony grasso): The steps involved to generate the entire website from scratch are # SVN checkout - [https://svn.apache.org/repos/asf/cassandra/site|https://svn.apache.org/repos/asf/cassandra/site] # Git clone Cassandra - [git@github.com:apache/cassandra.git|https://github.com/apache/cassandra] # Set the environment variable {{CASSANDRA_DIR}} to point to the SVN Cassandra checkout location # Install *Ruby 2.3.x* and *Make* for building the website # Install *Java 1.8.x*, *Python 2.7.x*, and *Python Sphinx* for generating the Cassandra docs # From the SVN Cassandra checkout install *Jekyll* - {{gem install bundler && bundle install}} # From the SVN Cassandra checkout _src_ directory run {{make add-doc}} to make the docs for latest # From the Git Cassandra checkout change to branch {{cassandra-3.11}} - {{git checkout cassandra-3.11}} # From the SVN Cassandra checkout _src_ directory run {{make add-doc}} again to make the docs for 3.11 # From the SVN Cassandra checkout _src_ directory run {{make}} to build the website Probably the easiest way to do this is to have a Docker contain which installs all the tools required to build the docs and the site. Inside of the container have an entry point script which performs the tasks to generate the docs and the site. This is my first take on it. These files are to be placed in the _svn.apache.org/repos/asf/cassandra/site_ directory. * [^docker-compose.yml] * [^docker-entrypoint.sh] * [^Dockerfile] > Provide a script or method to generate the entire website at the push of a button > --------------------------------------------------------------------------------- > > Key: CASSANDRA-14972 > URL: https://issues.apache.org/jira/browse/CASSANDRA-14972 > Project: Cassandra > Issue Type: Task > Components: Documentation/Website > Reporter: Anthony Grasso > Assignee: Anthony Grasso > Priority: Major > Attachments: Dockerfile, docker-compose.yml, docker-entrypoint.sh > > > The process involved to generate the website involves two repositories (Git and SVN), a range of tools, and a number of steps. > It would be good to have a script or something similar which we run and it will generate the entire website for us which is ready to commit back into SVN for publication. -- This message was sent by Atlassian JIRA (v7.6.3#76005) --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org For additional commands, e-mail: commits-help@cassandra.apache.org