Giter Club home page Giter Club logo

fluentd-docs's Introduction

Fluentd Docs App

Ultrasimple CMS and content for Fluentd documentation. The production site is here.

If you'd like to propose an edit to the Fluentd docs, please fork this repo and send us a pull request.

Install

$ gem install bundler
$ bundle install --path vendor/bundle
$ bundle exec rake server
$ open "http://localhost:9395/"

Test

$ bundle exec rake test 

Build Search Index

$ heroku run rake index

Deploy

We delopy fluentd-docs by Circle-CI automatically. If you want to delopy it manually, run following command.

$ git push heroku master

NOTE

When you have updated an article, please update config/last_updated.json too.

$ bundle exec rake last_updated
$ git add config/last_updated.json

Contributing docs for v1

v1 docs are under docs/v1. Currently, most articles are symlinked to the corresponding file in docs/.

  • If you are updating an exiting article. Just replace the symlink with an actual article.
  • If you are adding a new article, just add it under docs/v1.

Once v1 is released, this process will be updated.

INCLUDE pragma

You can use the "INCLUDE pragma" to avoid copy-and-pasting the same content or updates on multiple pages.

The syntax is as follows:

INCLUDE: <filename without extension>

... the rest of the document.

Please remember to include a blank line between "INCLUDE..." and the rest of the document. The docs app will search for <filename>.txt in the docs directory and insert its contents into the current document.

For example, if you write

INCLUDE: _buffer_parameters

... the rest of the document.

then the docs app will insert the contents of _buffer_parameters.txt into the current document.

Acknowledgement

This program is forked from heroku/heroku-docs, and originally written by @rtomayko and @adamwiggins. Later, modified by @kzk and @doryokujin.

Code is released under the MIT License: http://www.opensource.org/licenses/mit-license.php

All rights reserved on the content (text files in the docs subdirectory), although you're welcome to modify these for the purpose of suggesting edits.

fluentd-docs's People

Contributors

abe4tawa8 avatar akira-kuriyama avatar cesarandreu avatar chocoby avatar edsiper avatar frsyuki avatar hkmurakami avatar hokkai7go avatar hoshi-sano avatar ijin avatar jmoses avatar jwyuan avatar kiyoto avatar komamitsu avatar kzk avatar mr-salty avatar namusyaka avatar oza avatar prakharagarwal avatar repeatedly avatar sonots avatar suzukaze avatar syohex avatar tagomoris avatar tatsuyafw avatar tbenade avatar uu59 avatar voxik avatar y-ken avatar yoshi-taka avatar

Stargazers

 avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.