tree: e326711111d3dd252e94328689e5a77c5f54a85a [path history] [tgz]
  1. command/
  2. concept/
  3. contributing/
  4. extending/
  5. function/
  6. google-code-prettify/
  7. rule/
  8. setup/
  9. .nojekyll
  10. __common.soy
  11. buck.css
  12. favicon.png
  13. fork_me.png
  14. globals.json
  15. index.soy
  16. plovr-81ed862.jar
  17. publish.sh
  18. README.md
  19. soy2html.py
  20. soy2html.sh
  21. soyweb-local.sh
  22. 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!