kowalski / redcloth Goto Github PK
View Code? Open in Web Editor NEWThis project forked from jgarber/redcloth
RedCloth is a Ruby library for converting Textile into HTML.
Home Page: http://redcloth.org/
License: Other
This project forked from jgarber/redcloth
RedCloth is a Ruby library for converting Textile into HTML.
Home Page: http://redcloth.org/
License: Other
= RedCloth - Textile parser for Ruby Homepage:: http://redcloth.org Author:: Jason Garber Copyright:: (c) 2009 Jason Garber License:: MIT (See http://redcloth.org/textile/ for a Textile reference.) = RedCloth RedCloth is a Ruby library for converting Textile into HTML. == Installing RedCloth can be installed via RubyGems: gem install RedCloth It will install the appropriate Ruby, JRuby, or Win32 gem. If using JRuby, version 1.1.5 or greater is required. == Compiling If you just want to use RedCloth, you do NOT need to build/compile it. It is compiled from C sources automatically when you install the gem on the ruby platform. Precompiled binary gems are provided for JRuby and Win32 platforms. RedCloth can be compiled with <tt>rake compile</tt>. Ragel 6.3 or greater and the echoe gem are needed to build, compile, and package RedCloth. Again, Ragel and echoe are NOT needed to simply use RedCloth. === Supported platforms By default, the rake compile task builds a native C Ruby extension that works with Ruby 1.8 or 1.9. You can cross-compile for JRuby 1.3 with rake java compile and for Win32 with rake mingw compile. A pure Ruby version can be generated with rake pureruby compile, but the parser it produces is slow and incompatible with Ruby 1.9. The JRuby and pure-Ruby extensions don't support multi-byte characters. The RedCloth::EXTENSION_LANGUAGE constant indicates in which language your copy of RedCloth is compiled. == Bugs Please submit bugs to http://jgarber.lighthouseapp.com/projects/13054-redcloth/overview == Using RedCloth RedCloth is simply an extension of the String class, which can handle Textile formatting. Use it like a String and output HTML with its RedCloth#to_html method. Simple use: text = "This is *my* text." RedCloth.new(text).to_html Multi-line example: doc = RedCloth.new <<EOD h2. Test document Just a simple test. EOD puts doc.to_html == What is Textile? Textile is a simple formatting style for text documents, loosely based on some HTML conventions. == Sample Textile Text h2. This is a title h3. This is a subhead This is a bit of paragraph. bq. This is a blockquote. = Writing Textile A Textile document consists of paragraphs. Paragraphs can be specially formatted by adding a small instruction to the beginning of the paragraph. h3. Header 3. bq. Blockquote. # Numeric list. * Bulleted list. == Quick Phrase Modifiers Quick phrase modifiers are also included, to allow formatting of small portions of text within a paragraph. _emphasis_ __italicized__ *strong* **bold** ??citation?? -deleted text- +inserted text+ ^superscript^ ~subscript~ @code@ %(classname)span% ==notextile== (leave text alone) == Links To make a hypertext link, put the link text in "quotation marks" followed immediately by a colon and the URL of the link. Optional: text in (parentheses) following the link text, but before the closing quotation mark, will become a title attribute for the link, visible as a tool tip when a cursor is above it. Example: "This is a link (This is a title)":http://www.textism.com Will become: <a href="http://www.textism.com" title="This is a title">This is a link</a> == Images To insert an image, put the URL for the image inside exclamation marks. Optional: text that immediately follows the URL in (parentheses) will be used as the Alt text for the image. Images on the web should always have descriptive Alt text for the benefit of readers using non-graphical browsers. Optional: place a colon followed by a URL immediately after the closing ! to make the image into a link. Example: !http://www.textism.com/common/textist.gif(Textist)! Will become: <img src="http://www.textism.com/common/textist.gif" alt="Textist" /> With a link: !/common/textist.gif(Textist)!:http://textism.com Will become: <a href="http://textism.com"><img src="/common/textist.gif" alt="Textist" /></a> == Defining Acronyms HTML allows authors to define acronyms via the tag. The definition appears as a tool tip when a cursor hovers over the acronym. A crucial aid to clear writing, this should be used at least once for each acronym in documents where they appear. To quickly define an acronym in Textile, place the full text in (parentheses) immediately following the acronym. Example: ACLU(American Civil Liberties Union) Will become: <acronym title="American Civil Liberties Union">ACLU</acronym> == Adding Tables In Textile, simple tables can be added by separating each column by a pipe. |a|simple|table|row| |And|Another|table|row| Styles are applied with curly braces. table{border:1px solid black}. {background:#ddd;color:red}. |a|red|row|
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.