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.

130 lines
9.6 KiB

  1. [![DocPad Logo](http://d.pr/i/cfmt+)](http://docpad.org "Visit the DocPad Website")
  2. # DocPad. Streamlined web development.
  3. [![Check this project's build status on TravisCI](https://secure.travis-ci.org/bevry/docpad.png?branch=master)](http://travis-ci.org/bevry/docpad)
  4. [![View this project's NPM page](https://badge.fury.io/js/docpad.png)](https://npmjs.org/package/docpad)
  5. [![Donate monthly to this project via Flattr](https://raw.github.com/balupton/flattr-buttons/master/badge-89x18.gif)](http://flattr.com/thing/344188/balupton-on-Flattr)
  6. [![Donate once-off to this project via Paypal](https://www.paypalobjects.com/en_AU/i/btn/btn_donate_SM.gif)](https://www.paypal.com/au/cgi-bin/webscr?cmd=_flow&SESSION=IHj3DG3oy_N9A9ZDIUnPksOi59v0i-EWDTunfmDrmU38Tuohg_xQTx0xcjq&dispatch=5885d80a13c0db1f8e263663d3faee8d14f86393d55a810282b64afed84968ec)
  7. Hi! I'm DocPad, I streamline the web development process and help close the gap between experts and beginners. I've been used in production by big and small companies for over a year and a half now to create [plenty of amazing and powerful web sites and applications](http://docpad.org/docs/showcase) quicker than ever before. What makes me different is instead of being a box to cram yourself into and hold you back, I'm a freeway to what you want to accomplish, just getting out of your way and allowing you to create stuff quicker than ever before without limits. Leave the redudant stuff up to me, so you can focus on the awesome stuff.
  8. Discover my features below, or skip ahead to the installation instructions to get started with a [fully functional pre-made website](http://docpad.org/docs/skeletons) in a few minutes from reading this.
  9. **[Watch the Screencast!](http://www.youtube.com/watch?v=hvQCXDWh7Wg&feature=share&list=PLYVl5EnzwqsQs0tBLO6ug6WbqAbrpVbNf)**
  10. ## Features
  11. ### Out of the box
  12. - Competely file based meaning there is no pesky databases that need to be installed, and for version control you get to use systems like Git and SVN which you're already use to (You can still hook in remote data sources if you want, DocPad doesn't impose any limits on you, ever)
  13. - Choose from plenty of community maintained [pre-made websites](http://docpad.org/docs/skeletons) to use for your next project instead of starting from scratch everytime
  14. - Write your documents in any language, markup, templating engine, or pre-processor you wish (we're truly agnostic thanks to your plugin system). You can even mix and match them when needed by combining their extensions in a rails like fashion (e.g. `coffee-with-some-eco.js.coffee.eco`)
  15. - Changes to your website are automatically recompiled through our built in watch system
  16. - Add meta data to the top of your files to be used by templating engines to display non-standard information such as titles and descriptions for your documents
  17. - Display custom listings of content with our powerful [Query Engine](https://github.com/bevry/query-engine/) available to your templating engines
  18. - Abstract out generic headers and footers into layouts using our nested layout system
  19. - For simple static websites easily deploy your generated website to any web server like apache or github pages. For dynamic projects deploy them to servers like [heroku](http://www.heroku.com/) or [nodejitsu](http://nodejitsu.com/) to take advantage of custom routing with [express.js](http://expressjs.com/). [Deploy guide here](http://docpad.org/docs/deploy)
  20. - Built-in server to save you from having to startup your own, for dynamic deployments this even supports things like clean urls, custom routes and server-side logic
  21. - Robust architecture and powerful plugin system means that you are never boxed in unlike traditional CMS systems, instead you can always [extend DocPad](http://docpad.org/docs/extend) to do whatever you need it to do, and you can even write to bundle common custom functionality and distribute them through the amazing node package manager [npm](http://npmjs.org/)
  22. - Built in support for dynamic documents (e.g. search pages, signup forms, etc.), so you can code pages that change on each request by just adding `dynamic: true` to your document's meta data (exposes the [express.js](http://expressjs.com/) `req` and `res` objects to your templating engine)
  23. - You can use it standalone, or even easily include it within your existing systems with our [API](http://docpad.org/docs/api)
  24. ### With our amazing community maintained plugins
  25. - Use the [Live Reload](http://docpad.org/plugin/livereload/) plugin to automatically refresh your web browser whenever a change is made, this is amazing
  26. - Pull in remote RSS/Atom/JSON feeds into your templating engines allowing you to display your latest twitter updates or github projects easily and effortlessly using the [Feedr Plugin](http://docpad.org/plugin/feedr/)
  27. - Support for every templating engine and pre-processor under the sun, including but not limited to CoffeeScript, CoffeeKup, ECO, HAML, Handlebars, Jade, Less, Markdown, PHP, Ruby, SASS and Stylus - [the full listing is here](http://docpad.org/docs/plugins)
  28. - Use the [Partials Plugin](http://docpad.org/plugin/partials) to abstract common pieces of code into their own individual file that can be included as much as you want
  29. - Syntax highlight code blocks automatically with either our [Highlight.js Plugin](http://docpad.org/plugin/highlightjs/) or [Pygments Plugin](http://docpad.org/plugin/pygments/)
  30. - Get SEO friendly clean URLs with our [Clean URLs Plugin](http://docpad.org/plugin/cleanurls/) (dynamic deployments only)
  31. - Lint your code automatically with our Lint Plugin - under construction, coming soon
  32. - Concatenate and minify your JavaScript and CSS assets making page loads faster for your users with our Minify Plugin - under construction, coming soon
  33. - Install common javascript libraries like jQuery, Backbone and Underscore directly from the command line - under construction, coming soon
  34. - Automatically translate your entire website into other languages with our Translation Plugin - under construction, coming soon
  35. - Add a admin interface to your website allowing you to edit, save and preview your changes on live websites then push them back to your source repository with the Admin Plugin - under construction, coming soon
  36. - Pretty much if DocPad doesn't already do something, it is trivial to [write a plugin](http://docpad.org/docs/extend) to do it, seriously DocPad can accomplish anything, it never holds you back, there are no limits, it's like super powered guardian angel
  37. - There are also [plenty of other plugins](http://docpad.org/docs/plugins) not listed here that are still definitely worth checking out! :)
  38. ## People love DocPad
  39. All sorts of people love DocPad, from first time web developers to even industry leaders and experts. In fact, people even migrate to DocPad from other systems as they love it so much. Here are some our [favourite tweets](https://twitter.com/#!/DocPad/favorites) of what people are saying about DocPad :)
  40. [![Some favourite tweets about DocPad](https://raw.github.com/bevry/docpad/dev/docs/favs.gif)](https://twitter.com/#!/DocPad/favorites)
  41. ## [Installation](http://docpad.org/docs/install)
  42. [Click here for our latest Install Instructions](http://docpad.org/docs/install)
  43. ## [Quick Start](http://docpad.org/docs/start)
  44. [Click here to skip ahead to our latest Quick Start Guide](http://docpad.org/docs/start)
  45. ## What next?
  46. Here are some quick links to help you get started:
  47. - [Getting Started](http://docpad.org/docs/intro)
  48. - [Frequently Asked Questions](http://docpad.org/docs/faq)
  49. - [Showcase and Examples](http://docpad.org/docs/showcase)
  50. - [Guides and Tutorials](http://docpad.org/docs/)
  51. - [Deployment Guide](http://docpad.org/docs/deploy)
  52. - [Extension Guide](http://docpad.org/docs/extend)
  53. - [Plugins](http://docpad.org/docs/plugins)
  54. - [Skeletons](http://docpad.org/docs/skeletons)
  55. - [Troubleshooting](http://docpad.org/docs/troubleshoot)
  56. - [Support Channels](http://docpad.org/support)
  57. - [Bug Tracker](http://docpad.org/issues)
  58. - [IRC Chat Room: `#docpad` on freenode](http://webchat.freenode.net?channels=docpad)
  59. - [Everything else](http://docpad.org/docs/)
  60. ## History
  61. [You can discover the version history inside the `History.md` file](https://github.com/bevry/docpad/blob/master/History.md#files)
  62. ## License
  63. Licensed under the incredibly [permissive](http://en.wikipedia.org/wiki/Permissive_free_software_licence) [MIT License](http://creativecommons.org/licenses/MIT/)
  64. <br/>Copyright &copy; 2012+ [Bevry Pty Ltd](http://bevry.me)
  65. <br/>Copyright &copy; 2011 [Benjamin Lupton](http://balupton.com)
  66. ## Special Thanks
  67. Special thanks to all our wonderful contributors who have helped shaped the DocPad core of today:
  68. - [Benjamin Lupton](https://github.com/balupton)
  69. - [Nick Crohn](https://github.com/ncrohn)
  70. - [eldios](https://github.com/eldios)
  71. - [Changwoo Park](https://github.com/pismute)
  72. - [Bruno Héridet](https://github.com/Delapouite)
  73. - [Todd Anglin](https://github.com/toddanglin)
  74. - [Olivier Bazoud](https://github.com/obazoud)
  75. - [Zhao Lei](https://github.com/firede)
  76. - [Aaron Powell](https://github.com/aaronpowell)
  77. - [Andrew Patton](https://github.com/acusti)
  78. - [Paul Armstrong](https://github.com/paularmstrong)
  79. - [Sorin Ionescu](https://github.com/sorin-ionescu)
  80. - [Ferrari Lee](https://github.com/Ferrari)
  81. - [Ben Barber](https://github.com/barberboy)
  82. - [Sven Vetsch](https://github.com/disenchant)
  83. Also thanks to all the countless others who have continued to raise DocPad even higher by submitting plugins, issues reports, discussion topics, IRC chat messages, and praise on twitter. We love you.
  84. Lastly, thank YOU for giving us a go, believing us, and loving us. We love you too.
  85. Sincerely, the DocPad team
  86. [![Flattr this project](http://api.flattr.com/button/flattr-badge-large.png)](http://flattr.com/thing/344188/balupton-on-Flattr)