Page History

In HADOOP-14163, Apache Hadoop ASF web site has been migrated from SVN to Git.

The site source is in a dedicated repository under asf-site directory and the generated web site is in asf-site branch.As both of them are part of the same repository the site generation needs two checkoutbranch but in the content folder.

Generate the siteFirst you need a secondar

1. First you need a directory with the asf-site branch which contains the rendered site:

git worktreeclone add ..git@github.com:apache/hadoop-site asf-site

...

.git

For committers (without gitbox integration) use the following url:

git clone https://git-wip-us.apache.org/repos/asf/hadoop.git

2. Second you need the Hugo site generator. As it's written in go, all you need is a single binary. You can download it from the release page (or you can check the documentation)

3. Now you can generate the site:

hugo --source asf-site --destination `pwd`/../hadoop-site

Check the results:

firefox

...

 content/index.html

You can also check the result immediately:

hugo server

And chech http://localhost:1313 --source asf-site server

Create a new page

To create a new item on the hadoop site just create a new markdown file with header. For example:

Put it to the src/releases folder:

---

title: Release 2.8.1 available
date: 2017-06-08
linked: true
---
<!---
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License. See accompanying LICENSE file.
-->

This is a security release in the 2.8.0 release line. It consists of
2.8.0 plus security fixes. Users on 2.8.0 are encouraged to upgrade to
2.8.1.

Please note that 2.8.x release line continues to be not yet ready for
production use. Critical issues are being ironed out via testing and
downstream adoption. Production users should wait for a subsequent
release in the 2.8.x line.

...