Website Development

Apache Ignite uses Bootstrap framework for its website.

Setting Up

Check out the website from Git:

$ git checkout https://github.com/apache/ignite-website

Note, that all the commits to the master branch update the production version of the website (https://ignite.apache.org) on-the-fly. Thus, we encourage all website contributors to set up a local version and check changes before pushing anything into production. Contributors have to send pull-requests through the Git repository. Committers should send changes at least for a post-commit review to the website maintainers (Denis Magda).

Local deploy of website using apache

Open httpd.conf file located in /etc/apache2, and make following changes:

1. Load the mod_include module by adding or uncommenting the following line, near the top of the file on Mac OS X 10.10.4:

   LoadModule include_module libexec/apache2/mod_include.so

   You can also use the a2enmod command in environments other than Mac OS X.

2. Locate in your file :

   #ServerName www.example.com:80

   ...

   ...

   #
   # Controls who can get stuff from this server.
   #
   Require all granted
   </Directory>

   
   

3. Replace all that code with the one below :

   #ServerName www.example.com:80
   #
   # Deny access to the entirety of your server's filesystem. You must
   # explicitly permit access to web content directories in other
   # <Directory> blocks below.
   #
   <Directory />
       AllowOverride none
       Require all denied
   </Directory>
   #
   # Note that from this point forward you must specifically allow
   # particular features to be enabled - so if something's not working as
   # you might expect, make sure that you have specifically enabled it
   # below.
   #
   #
   # DocumentRoot: The directory out of which you will serve your
   # documents. By default, all requests are taken from this directory, but
   # symbolic links and aliases may be used to point to other locations.
   #
   DocumentRoot "/Users/prachig/ignite-web/website/trunk"
   <Directory "/Users/prachig/ignite-web/website/trunk">
       #
       # Possible values for the Options directive are "None", "All",
       # or any combination of:
       #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
       #
       # Note that "MultiViews" must be named *explicitly* --- "Options All"
       # doesn't give it to you.
       #
       # The Options directive is both complicated and important.  Please see
       # http://httpd.apache.org/docs/2.4/mod/core.html#options
       # for more information.
       #
       Options FollowSymLinks Multiviews Includes
       MultiviewsMatch Any
       #
       # AllowOverride controls what directives may be placed in .htaccess files.
       # It can be "All", "None", or any combination of the keywords:
       #   AllowOverride FileInfo AuthConfig Limit
       #
       AllowOverride None
       #
       # Controls who can get stuff from this server.
       #
       Require all granted
   </Directory>

   Make sure to provide correct values for: 

   DocumentRoot "path-to-ignite-website-folder" 

   <Directory "path-to-ignite-website-folder">

   
   

4. Locate in your file:

   <IfModule mime_module>
   ...
   ...
   # To parse .shtml files for server-side includes (SSI):
   # (You will also need to add "Includes" to the "Options" directive.)
   #
   #AddType text/html .shtml
   #AddOutputFilter INCLUDES .shtml
   </IfModule>

   
   

5. Add following lines after comments:

   AddType text/html .html
   AddOutputFilter INCLUDES .html

6. Start Apache HTTP Server, in the terminal, using:

   $ sudo apachectl start

   If this command fails for you try this instead:

   sudo apachectl -k start

7. In your browser, type- localhost:80

   
   

Edit CSS

You can edit "all.scss" and "ignite.scss" files. Run SCSS watchdog using:

 $ compass watch scss/all.scss

To make sure browsers upload the most recent Ignite CSS files update the css version number in HTML files by running the following script at 'trunk' level :

grep -rl 'all.css?v=1.5' * | xargs sed -i '' 's/all.css?v=1.5/all.css?v=1.6/g'

Here, 1.5 (just some number as example) is the existing version, and 1.6 is the new version.