You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
rocksdb/docs
Joel Marcey 2adab1dde2 Add API links to the header bar 8 years ago
..
_data Add API links to the header bar 8 years ago
_docs Add FAQ based on the front page of the current rocksdb.org 8 years ago
_includes Have "Edit on GitHub" point to master instead of gh-pages 8 years ago
_layouts Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
_posts Preserve blog comments in markdown 8 years ago
_sass Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
blog Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
css Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
docs Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
static Migrate the RocksDB Worpdress blog over to Jekyll 8 years ago
.gitignore Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
Gemfile Add redirects from old blog posts link to new format 8 years ago
Gemfile.lock Add redirects from old blog posts link to new format 8 years ago
README.md Update docs README.md 8 years ago
_config.yml Add real Google Analytics ID 8 years ago
_config_local_dev.yml Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
feed.xml Add initial GitHub pages infra for RocksDB documentation move and update. (#1294) 8 years ago
index.md Initial Landing Page 8 years ago
support.md Add FAQ based on the front page of the current rocksdb.org 8 years ago

README.md

User Documentation for rocksdb.org

This directory will contain the user and feature documentation for RocksDB. The documentation will be hosted on GitHub pages.

Run the Site Locally

The requirements for running a GitHub pages site locally is described in GitHub help. The steps below summarize these steps.

  1. Make sure you have Ruby and RubyGems installed.

    Ruby >= 2.2 is required for the gems. On the latest versions of Mac OS X, Ruby 2.0 is the default. Use brew install ruby (or your preferred upgrade mechanism) to install a newer version of Ruby for your Mac OS X system.

  2. Make sure you have Bundler installed.

    # may require sudo
    gem install bundler
    
  3. Install the project's dependencies

    # run this in the 'docs' directory
    bundle install
    

    If you get an error when installing nokogiri, you may be running into the problem described in this nokogiri issue. You can either brew uninstall xz (and then brew install xz after the bundle is installed) or xcode-select --install (although this may not work if you have already installed command line tools).

  4. Run Jekyll's server.

    bundle exec jekyll serve --config=_config.yml,_config_local_dev.yml
    

    We use bundle exec instead of running straight jekyll because bundle exec will always use the version of Jekyll from our Gemfile. Just running jekyll will use the system version and may not necessarily be compatible.

  5. The site will be served from http://localhost:4000.

Updating the Bundle

The site depends on Github Pages and the installed bundle is based on the github-pages gem. Occasionally that gem might get updated with new or changed functionality. If that is the case, you can run:

bundle update

to get the latest packages for the installation.