Gitiles
Code Review Sign In
asterix-gerrit.ics.uci.edu / incubator-asterixdb-site / 2a32102e5e437279db23b54e532586f6ca6ab7eb / . / content / site.html
blob: af1ca12301164af7a537f1a0a6cc31fc645339c3 [file] [log] [blame]
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]1<!DOCTYPE html>
2<html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <meta http-equiv="X-UA-Compatible" content="IE=edge">
6 <meta name="viewport" content="width=device-width, initial-scale=1">
7 <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
8 <meta name="description" content="">
9 <meta name="author" content="">
10 <link rel="icon" href="favicon.ico">
11
12 <title>Editing this website</title>
13
14 <!-- Bootstrap core CSS -->
15 <link href="css/bootstrap.min.css" rel="stylesheet">
16 <!-- Bootstrap theme -->
17
18 <!-- Custom styles for this template -->
19 <link href="css/theme.css" rel="stylesheet">
20
21 <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
22 <!--[if lt IE 9]>
23 <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
24 <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
25 <![endif]-->
26 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
27 </head>
28
29 <div class="container theme-showcase" role="main">
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]30 <div class="masthead">
31 <p class="lead">
32 <a href="index.html">
33 <img src="img/asterixdb_tm.png" style="height:75px; width:auto; vertical-align:bottom; margin-top:10px;"/>
34 </a>
35 </p>
36 </div>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]37
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]38 <nav class="navbar navbar-default">
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]39 <div class="container">
40 <div class="navbar-header">
41 <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
42 <span class="sr-only">Toggle navigation</span>
43 <span class="icon-bar"></span>
44 <span class="icon-bar"></span>
45 <span class="icon-bar"></span>
46 </button>
47 <a class="navbar-brand" href="index.html">Overview</a>
48 </div>
49 <div class="navbar-collapse collapse">
50 <ul class="nav navbar-nav">
51 <li><a href="download.html">Download</a></li>
52 <li class="dropdown">
53 <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Documentation<span class="caret"></span></a>
54 <ul class="dropdown-menu" role="menu">
55 <li class="dropdown-header">Stable release</li>
Till Westmanne617e522016-02-29 12:42:51 -0800[diff] [blame]56 <li><a href="docs/0.8.8-incubating/index.html">Documentation for 0.8.8-incubating<i class="fa fa-external-link fa-sm"></i></a></li>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]57 <li class="divider"></li>
58 <li class="dropdown-header">Snapshot release</li>
Ian Maxona1d49092016-03-25 13:24:08 -0700[diff] [blame]59 <li><a href="https://ci.apache.org/projects/asterixdb/index.html">Documentation for 0.8.9-SNAPSHOT <i class="fa fa-external-link fa-sm"></i></a></li>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]60 </ul>
61 </li>
62 <li><a href="about.html">About</a></li>
Till Westmann2a321022016-04-08 08:18:14 -0700[diff] [blame^]63 <li class="dropdown">
64 <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Community<span class="caret"></span></a>
65 <ul class="dropdown-menu" role="menu">
66 <li><a href="community.html">Mailing Lists</a></li>
67 <li><a href="community.html#irc">IRC</a></li>
68 <li><a href="community.html#asterixdb-team">Team</a></li>
69 <li><a href="https://issues.apache.org/jira/browse/ASTERIXDB">Issue Tracker</a></li>
70 </ul>
71 </li>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]72 <li class="dropdown">
73 <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Contributing <span class="caret"></span></a>
74 <ul class="dropdown-menu" role="menu">
75 <li class="dropdown-header">For New Contributors</li>
76 <li><a href="dev-setup.html">Development Setup</a></li>
77 <li class="divider"></li>
78 <li class="dropdown-header">For Committers</li>
79 <li><a href="pushing.html">Pushing changes</a></li>
80 <li><a href="site.html">Editing this site</a></li>
81 </ul>
82 </li>
83 </ul>
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]84 <ul class="nav navbar-nav navbar-right">
85 <li class="dropdown">
86 <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false"
87 style="padding-right: 30px">
88 <img src="img/feather.png" style="height:20px"/>Apache Software Foundation<span class="caret"/>
89 </a>
90 <ul class="dropdown-menu dropdown-menu-right" role="menu">
91 <li><a href="http://www.apache.org/"><b>ASF Homepage</b></a></li>
92 <li><a href="http://www.apache.org/licenses/">License</a></li>
93 <li><a href="http://www.apache.org/foundation/sponsorship.html">Donate</a></li>
94 <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
95 <li><a href="http://www.apache.org/security/">Security</a></li>
96 </ul>
97 </li>
98 </ul>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]99 </div><!--/.nav-collapse -->
100 </div>
101 </nav>
102
103
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]104 <div class="row">
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]105<div class="col-md-8 col-centered">
106<h2>Editing this website</h2>
107<!-- Major credit to the Apache Flink guys for writing a great doc in a similar vein for their website
108that happens to use more or less the same tooling as AsterixDB's. Much of this doc is based on it. -->
109
110<ul id="markdown-toc">
111 <li><a href="#prerequisites" id="markdown-toc-prerequisites">Prerequisites</a> <ul>
112 <li><a href="#jekyll" id="markdown-toc-jekyll">Jekyll.</a></li>
113 <li><a href="#checking-out-the-website-sources" id="markdown-toc-checking-out-the-website-sources">Checking out the website sources</a></li>
114 </ul>
115 </li>
116 <li><a href="#making-a-change-to-the-site" id="markdown-toc-making-a-change-to-the-site">Making a change to the site</a> <ul>
117 <li><a href="#editing-and-viewing-the-change" id="markdown-toc-editing-and-viewing-the-change">Editing and viewing the change.</a></li>
118 <li><a href="#submitting-the-change-to-the-live-site" id="markdown-toc-submitting-the-change-to-the-live-site">Submitting the change to the live site</a></li>
119 </ul>
120 </li>
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]121 <li><a href="#troubleshooting" id="markdown-toc-troubleshooting">Troubleshooting</a></li>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]122</ul>
123
124<hr />
125
126<h2 id="prerequisites">Prerequisites</h2>
127
128<h3 id="jekyll">Jekyll.</h3>
129<p>This website is written using a static website generator called <a href="https://github.com/jekyll/jekyll">Jekyll</a>. To work with editing this website you will need to install it.
130In short, Jekyll uses a combination of templated HTML files and Markdown to compile the final site.
131Generally, the content itself lies within the Markdown files, and the HTML is for layout.
132A full tutorial about how to use Jekyll is out of the scope of this document, but, for our purposes, only Markdown will be edited.</p>
133
134<h3 id="checking-out-the-website-sources">Checking out the website sources</h3>
135
136<p>The website is managed using <code>git</code>. Clone the site as usual</p>
137
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]138<pre><code>➤ git clone -b asf-site https://git-wip-us.apache.org/repos/asf/incubator-asterixdb-site.git
Till Westmann1dba8882016-02-29 15:44:42 -0800[diff] [blame]139</code></pre>
140
141<p>and <code>cd</code> into the clone</p>
142
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]143<pre><code>➤ cd incubator-asterixdb-site
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]144</code></pre>
145
146<p>You will notice lots of Markdown files and HTML templates in the repository root. The compiled content of the website itself is served from the <code>content/</code> folder in this repository. That is to say, that the actual content of the website itself, as well as its sources are stored in the same repository. Additionally, the main branch on this repository is <code>asf-site</code> and not <code>master</code></p>
147
148<p>Gerrit is used to submit code reviews for the website just as it is with the main codebase. The main difference the site is not strictly subject to code reviews.</p>
149
Till Westmann1dba8882016-02-29 15:44:42 -0800[diff] [blame]150<p>Then, you likely will want to check out to make your own topic branch as to not work directly on the “live” branch, like so:</p>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]151
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]152<pre><code>➤ git checkout -b YOU/site
Till Westmann1dba8882016-02-29 15:44:42 -0800[diff] [blame]153</code></pre>
154
155<p>And perform the git-gerrit init on this branch</p>
156
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]157<pre><code>➤ git gerrit init -u ssh://YOU@asterix-gerrit.ics.uci.edu:29418/ -p incubator-asterixdb-site
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]158</code></pre>
159
160<h2 id="making-a-change-to-the-site">Making a change to the site</h2>
161
Till Westmann1dba8882016-02-29 15:44:42 -0800[diff] [blame]162<p>The general overview is as follows:</p>
163
164<ul>
165 <li>Make edits and check the output of <code>jekyll build</code></li>
166 <li>Commit the change and propose it for review</li>
167 <li>Either wait for a review, or submit the change</li>
168</ul>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]169
170<h3 id="editing-and-viewing-the-change">Editing and viewing the change.</h3>
171
172<p>For whichever section of the site you want to edit, go ahead and do so with the text editor of your choice. Then, to see what your change looks like, in the repository root, execute:</p>
173
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]174<pre><code>➤ jekyll serve --watch
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]175</code></pre>
176
177<p>This sets up a small integrated web server and compiles the site dynamically as it is edited. Once you are satisfied with how the site looks, go ahead and commit your changes with git.</p>
178
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]179<p>Once you have made your commit, push it to Gerrit for review:</p>
180
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]181<pre><code>➤ git gerrit submit -b asf-site
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]182</code></pre>
183
Till Westmann1dba8882016-02-29 15:44:42 -0800[diff] [blame]184<p>For longer edits you might need to update your local <code>asf-site</code> mirror, and then merge that onto your working branch. This will prevent your branch from falling too far out of date, and ensure that your code review proposals will merge successfully with <code>master</code>. Similar to the way this is done for code changes you can use</p>
185
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]186<pre><code>➤ git gerrit update -b asf-site
Till Westmann1dba8882016-02-29 15:44:42 -0800[diff] [blame]187</code></pre>
188
189<p>to do this.</p>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]190
191<h3 id="submitting-the-change-to-the-live-site">Submitting the change to the live site</h3>
192
193<p>When the submitted review is committed in Gerrit, pull it and overwrite your current asf-site branch:</p>
194
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]195<pre><code>➤ git fetch gerrit
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]196</code></pre>
197
198<p>Then, push the exact commit from the Gerrit web interface to the ASF git repository. Do this with care! ASF git doesn’t allow hard resets on branches, so whatever you push here is final.</p>
199
Till Westmannabfde422016-02-29 18:57:58 -0800[diff] [blame]200<pre><code>➤ git push origin (SHA1 of submitted commit):asf-site
201</code></pre>
202
203<h2 id="troubleshooting">Troubleshooting</h2>
204
205<p>If jekyll produces an error message like this one:</p>
206
207<pre><code>➤ jekyll serve --watch
208Configuration file: /.../incubator-asterixdb-site/_config.yml
209You are missing a library required for syntax highlighting. Please run:
210$ [sudo] gem install pygments
211jekyll 3.1.2 | Error: uninitialized constant Kramdown::Converter::PygmentsHtml::FatalException
212</code></pre>
213
214<p>this might fix it:</p>
215
216<pre><code>➤ sudo gem install pygments.rb
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]217</code></pre>
218
219
220</div>
221</div>
222
223
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]224 <hr/>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]225
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]226 <footer>
227 <div class="row">
228 <div class="col-md-9 col-centered">
229 <div class="col-md-9 text-left">
230 <p>Apache AsterixDB is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored
231 by the Apache Incubator.
232 Incubation is required of all newly accepted projects until a further review indicates that the
233 infrastructure, communications, and decision making process have stabilized in a manner consistent with
234 other successful ASF projects.
235 While incubation status is not necessarily a reflection of the completeness or stability of the code, it
236 does indicate that the project has yet to be fully endorsed by the ASF.</p>
237 </div>
238 <div class="col-md-3 text-right">
239 <img src="img/egg-logo.png" style="height:auto; width:200px; vertical-align:bottom;"/>
240 </div>
241 </div>
242 </div>
243 <div class="row">
244 <div class="col-md-9 col-centered text-center">
245 <p/>
246 <p>&copy; Copyright 2016 The Apache Software foundation. All Rights Reserved. </p>
247 <p>Apache AsterixDB, the Apache AsterixDB logo, Apache, and the Apache feather logo are trademarks of the
248 Apache Software Foundation</p>
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]249 </div>
Till Westmann00f9bf22016-03-14 13:59:27 -0700[diff] [blame]250 </div>
251 </footer>
252 </div> <!-- /container -->
Ian Maxonf84cb812015-12-07 15:09:45 -0800[diff] [blame]253
254 <!-- Bootstrap core JavaScript
255 ================================================== -->
256 <!-- Placed at the end of the document so the pages load faster -->
257 <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
258 <script src="js/bootstrap.min.js"></script>
259 </body>
260</html>