YASnippet re-design and re-writing of my original extension
smart-snippet. The goal is ease of use and full features.
-You can find a brief configuration guide on the project homepage:
-http://code.google.com/p/yasnippet/ . Detailed documentation can also
-be found there (the wiki pages on the right sidebar).
+Detailed document can be found in the doc directory of the
+distribution.
\ No newline at end of file
desc "create a release package"
task :package do
release_dir = "pkg/yasnippet-#{$version}"
- FileUtils.mkdir_p(release_dir)
+ FileUtils.mkdir_p(release_dir + "/doc")
files = ['snippets', 'yasnippet.el', 'Rakefile']
FileUtils.cp_r files, release_dir
+ Dir['doc/*.html'].each { |f|
+ FileUtils.cp f, release_dir + '/doc' + f.sub(/^doc/, "")
+ }
FileUtils.rm_r Dir[release_dir + "/**/.svn"]
FileUtils.cd 'pkg'
sh "tar cjf yasnippet-#{$version}.tar.bz2 yasnippet-#{$version}"
end
-task :default => :bundle
+desc "Generate document"
+task :doc do
+ docs = Dir['doc/*.rst']
+ docs.each { |file|
+ sh "doc/compile-doc.py #{file} #{file.sub(/rst$/, "html")}"
+ }
+end
+
+task :default => :doc
--- /dev/null
+#!/usr/bin/python
+# Compile document to HTML use docutils.
+
+# ========================================
+# Pygments syntax highlighting
+# ========================================
+from pygments.formatters import HtmlFormatter
+
+# Set to True if you want inline CSS styles instead of classes
+INLINESTYLES = False
+
+from pygments.formatters import HtmlFormatter
+
+# The default formatter
+DEFAULT = HtmlFormatter(noclasses=INLINESTYLES)
+
+# Add name -> formatter pairs for every variant you want to use
+VARIANTS = {
+ # 'linenos': HtmlFormatter(noclasses=INLINESTYLES, linenos=True),
+}
+
+from docutils import nodes
+from docutils.parsers.rst import directives
+
+from pygments import highlight
+from pygments.lexers import get_lexer_by_name, TextLexer
+
+def pygments_directive(name, arguments, options, content, lineno,
+ content_offset, block_text, state, state_machine):
+ try:
+ lexer = get_lexer_by_name(arguments[0])
+ except ValueError:
+ # no lexer found - use the text one instead of an exception
+ lexer = TextLexer()
+ # take an arbitrary option if more than one is given
+ formatter = options and VARIANTS[options.keys()[0]] or DEFAULT
+ parsed = highlight(u'\n'.join(content), lexer, formatter)
+ return [nodes.raw('', parsed, format='html')]
+
+pygments_directive.arguments = (1, 0, 1)
+pygments_directive.content = 1
+pygments_directive.options = dict([(key, directives.flag) for key in VARIANTS])
+
+directives.register_directive('sourcecode', pygments_directive)
+
+
+# ========================================
+# Command line processing
+# ========================================
+from docutils.core import publish_cmdline, default_description
+
+
+description = ('Generates (X)HTML documents from standalone reStructuredText '
+ 'sources. ' + default_description)
+
+publish_cmdline(writer_name='html', description=description)
;; Copyright 2008 pluskid
;;
;; Author: pluskid <pluskid@gmail.com>
-;; Version: 0.3.2
+;; Version: 0.4.0
;; X-URL: http://code.google.com/p/yasnippet/
;; This file is free software; you can redistribute it and/or modify
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Internal variables
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-(defvar yas/version "0.3.2")
+(defvar yas/version "0.4.0")
(defvar yas/snippet-tables (make-hash-table)
"A hash table of snippet tables corresponding to each major-mode.")