Google Git
Sign in
apache / arrow-site / 32f5eaecafbf75548078317d0de289fe7ea24299
commit32f5eaecafbf75548078317d0de289fe7ea24299[log] [tgz]
authorAndy Grove <andygrove73@gmail.com>Sun Apr 11 17:25:55 2021 -0600
committerAndy Grove <andygrove73@gmail.com>Sun Apr 11 17:25:55 2021 -0600
treefed8df7513051dcc793a8449e750aec07528a9ea
parent51d92d60eceba8e85758161b003102cae24bdfc5 [diff]
remove benchmark
2 files changed
tree: fed8df7513051dcc793a8449e750aec07528a9ea
  1. .github/
  2. _data/
  3. _docs/
  4. _includes/
  5. _layouts/
  6. _posts/
  7. _release/
  8. _webpack/
  9. assets/
  10. css/
  11. img/
  12. scripts/
  13. .gitignore
  14. _config.yml
  15. arrow.rdf
  16. blog.html
  17. committers.md
  18. community.md
  19. faq.md
  20. Gemfile
  21. index.html
  22. install.md
  23. overview.md
  24. package-lock.json
  25. package.json
  26. powered_by.md
  27. Rakefile
  28. README.md
  29. release-announcement-template.md
  30. robots.txt
  31. security.md
  32. use_cases.md
  33. webpack.config.js
README.md

Apache Arrow Website

Overview

Jekyll is used to generate HTML files from the Markdown + templates in this repository. The built version of the site is kept on the asf-site branch, which gets deployed to https://arrow.apache.org.

Adding Content

To add a blog post, create a new markdown file in the _posts directory, following the model of existing posts. In the front matter, you should specify an “author”. This should be your Apache ID if you have one, or it can just be your name. To add additional metadata about yourself (GitHub ID, website), add yourself to _data/contributors.yml. This object is keyed by apacheId, so use that as the author in your post. (It doesn't matter if the ID actually exists in the ASF; all metadata is local to this project.)

Prerequisites

With non-EOL-ed Ruby installed, run the following commands to install Jekyll.

gem install bundler
bundle install

We also need Node.JS to use webpack for maintaining dependent JavaScript and CSS libraries.

We can install webpack and dependent JavaScript and CSS libraries automatically by following command lines to preview or build the site. So we just need to install Node.JS here.

Previewing the site

Run the following and open http://localhost:4000/ to preview generated site locally:

bundle exec rake

Deployment

On commits to the master branch of apache/arrow-site, the rendered static site will be published to the asf-site branch using GitHub Actions. On a fork, it will deploy to your gh-pages branch for deployment via GitHub Pages; this is useful for previewing changes you're proposing.

FYI: We can also generate the site for https://arrow.apache.org/ to _site/ locally by the following command line:

JEKYLL_ENV=production bundle exec rake generate

Updating Code Documentation

To update the documentation, you can run the script ./dev/gen_apidocs.sh in the apache/arrow repository. This script will run the code documentation tools in a fixed environment.

C (GLib)

First, build Apache Arrow C++ and Apache Arrow GLib. This assumes that you have checkouts your forks of arrow and arrow-site alongside each other in your file system.

mkdir -p ../cpp/build
cd ../cpp/build
cmake .. -DCMAKE_BUILD_TYPE=debug
make
cd ../../c_glib
./autogen.sh
./configure \
  --with-arrow-cpp-build-dir=$PWD/../cpp/build \
  --with-arrow-cpp-build-type=debug \
  --enable-gtk-doc
LD_LIBRARY_PATH=$PWD/../cpp/build/debug make GTK_DOC_V_XREF=": "
rsync -r doc/reference/html/ ../../arrow-site/asf-site/docs/c_glib/

JavaScript

cd ../js
npm run doc
rsync -r doc/ ../../arrow-site/asf-site/docs/js

Then add/commit/push from the asf-site/ git checkout.