包详细信息

selleck

yui1400.1.18

Generator for YUI's Handlebars-based user documentation.

yui, handlebars, mustache, docs

自述文件

Selleck

Selleck is a tool for generating documentation from Mustache-based templates. It was created to generate documentation for the YUI Library. It's still young and evolving rapidly, but you may find it useful.

See http://yui.github.com/selleck/ for detailed information and usage instructions, as well as an example of the kinds of docs Selleck generates.

If you'd like to see more, check out this sample of the YUI 3 AutoComplete docs and examples, generated using Selleck.

Build Status

Build Status

License

Copyright (c) 2012 Yahoo! Inc. All rights reserved.

Redistribution and use of this software in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither the name of Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission of Yahoo! Inc.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Third-Party Code

Selleck uses the following third-party code, either as dependencies or (where indicated) included in the Selleck distribution.

Distributed With Selleck

Google Code Prettify (Apache License, Version 2.0)

A simple code syntax highlighter written in JavaScript (http://code.google.com/p/google-code-prettify/). Included in Selleck at themes/default/assets/vendor/prettify.

Copyright (C) 2006 Google Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Handlebars.js (MIT License)

A Mustache-like templating language in JavaScript. (https://github.com/wycats/handlebars.js). Included in Selleck at support/handlebars.

Copyright (C) 2011 by Yehuda Katz

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

External Dependencies

Express (MIT License)

A high-performance web development framework for Node.js (http://expressjs.com/).

Copyright (c) 2009-2010 TJ Holowaychuk <tj@vision-media.ca>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

更新日志

Selleck History

0.1.15 (2012-09-04)

  • Log errors to stderr instead of stdout. [Evan Goer]

0.1.14 (2012-08-14)

  • Fixed a bug in which examples weren't properly cross-linked in server mode. [Dav Glass]

0.1.13 (2012-04-19)

  • Node 0.8.x compatibility.

  • Added custom header and footer partials for easier theme overrides. [Dav Glass]

0.1.12 (2012-03-02)

  • Fixed a trailing comma in the Prettify JS.

0.1.11 (2012-03-01)

  • You can now explicitly specify a language name (like "js" or "handlebars") after the opening triple-backticks of a code block to force Prettify to treat the block as that language rather than relying on auto-detection.

  • Add Handlebars+HTML highlighting support to the version of Prettify distributed with Selleck. Prettify can't auto-detect Handlebars, so you need to explicitly specify "handlebars" after the opening triple-backticks of a code block to enable it.

0.1.10 (2012-01-19)

  • Sub-pages of component pages may now contain their own examples. [Dav Glass]

0.1.9 (2011-12-12)

  • Fixed a bug in the delimiter-escaping change that caused an exception on empty templates.

0.1.8 (2011-12-12)

  • Literal Mustache/Handlebars delimiters can now be output in generated docs by escaping them with a backslash: \{{foo\}} will output the literal string "{{foo}}".

0.1.7 (2011-10-27)

  • Node 0.5.x/0.6.x compatibility.

  • Now using graceful-fs to avoid EMFILE errors due to too many open file handles when generating lots of docs.

  • Default theme now looks a lot more like yuilibrary.com.

0.1.6 (2011-09-27)

  • Fixed a bug that caused the hasOwnExamples property to be set to true even if a component only had inherited examples.

  • Fixed a bug that caused component override metadata to be merged into project metadata.

0.1.5 (2011-07-29)

  • All metadata is now parsed before assets are copied and pages are generated.

  • Shared examples are now displayed in the example list for all components listed in the example's "modules" array.

  • Combined metadata output now includes fully-merged component metadata instead of the partially-merged metadata that was included before.

  • Views for non-component and non-example pages now have a boolean page property that's set to true (examples similarly have an example property).

  • Added a --dump-views option that causes view data to be written to a .json file alongside each generated page.

  • Fixed a bug that prevented symlinked input directories from being recognized.

0.1.4 (2011-06-28)

  • Changed the default doc output directory name to "build_docs", since "docs" tended to result in people accidentally overwriting their source assets when they ran Selleck from the wrong directory.

  • Updated to latest upstream Handlebars.js from git, which now includes all the bug fixes that were in Selleck's customized Handlebars build.

  • Updated Express dependency range to allow 2.4.x.

0.1.3 (2011-04-29)

  • Replaced Mustache.js with Handlebars.js.

  • npm 1.0 compatibility (I hope).

0.1.2 (2011-04-28)

  • Project pages are no longer merged into components.

  • Page title format tweaks.

0.1.1 (2011-03-11)

  • Updated Express dependency to 2.0.0.

  • Override metadata is now merged into global metadata output.

  • Server mode now throws errors for easier debugging. [Dav Glass]

0.1.0 (2011-03-08)

  • Initial release.