tree: 0e1702886f0d8633fc24907bb152b5bcbe9ab276 [path history] [tgz]
  1. about/
  2. command/
  3. concept/
  4. contributing/
  5. extending/
  6. function/
  7. google-code-prettify/
  8. rule/
  9. setup/
  10. static/
  11. .nojekyll
  12. __common.soy
  13. globals.json
  14. index.soy
  15. plovr-81ed862.jar
  16. publish.sh
  17. README.md
  18. soy2html.py
  19. soy2html.sh
  20. soyweb-local.sh
  21. soyweb-prod.sh
docs/README.md

This directory contains the templates for Buck's HTML documentation, as well as the scripts to publish said documentation.

Editing Documentation

Buck documentation is written using Closure Templates. Documentation can be developed locally by running the following command:

./docs/soyweb-local.sh

and then navigating to http://localhost:9811/ in the browser. The typical edit/refresh style of web development applies for editing these docs. Ideally, changes to Buck code will include updates to these docs in the same commit so that the relationship between the code and documentation changes is clear.

Note that the edit/refresh cycle of local documentation development is made possible via plovr.

Publishing Documentation

This documentation is hosted publicly at http://facebook.github.com/buck/ using GitHub Pages. Therefore, to publish this documentation, you must commit it on the gh-pages branch of the GitHub repository by running:

./docs/soyweb-prod.sh &
./docs/publish.sh
fuser -k -n tcp 9814

Creating a New Article

Create a file and seed it with the following content:

{namespace buck.ADD_YOUR_PAGE_NAME}

/***/
{template .soyweb}
  {call buck.page}
    {param title: 'ADD_YOUR_TITLE' /}
    {param content}

ADD_YOUR_CONTENT_HERE

    {/param}
  {/call}
{/template}

Update the three placeholders in all caps and you should be good to go!