Ace Editor Module ( https://drupal.org/project/ace_editor )
======================
by Max Nylin, max@articstudios.se
by Olivier GIRARD, girardol182@gmail.com



Description
===========

AceEditor is a code editor written in JavaScript, allowing you to edit HTML, PHP and JavaScript (and more).
It provides syntax highlighting, proper indentation, keyboard shortcuts, find and replace (including
regular expressions).

This module integrates the Ace editor into Drupal's node/block edit forms, for editing raw
HTML/PHP/JavaScript (with more) in a familiar way.
It also provides a display formatter, along with a text filter and an API to embed and show code snippets in your content.



Installation
============

1. Download the latest version of the Ace Editor at https://github.com/ajaxorg/ace-builds/
   or directly via https://github.com/ajaxorg/ace-builds/archive/master.zip
   Do not use a version < 1.0.0.
2. Extract and place the contents of the zip file under sites/all/libraries so that ace.js
   is located at sites/all/libraries/ace/src/ace.js .
   If you want to use any of the other src (minified, noconflict...), make sure you rename the folder as "src" for the module to find it.
3. Download, extract and copy the ace_editor module to your sites/all/modules directory.
4. Enable the "Ace HTML Editor" module on your Drupal Modules page, under the Administration heading.
   An example "HTML Editor" text format is added that uses the Ace editor for editing content.



Features
========

Edit HTML and PHP in your nodes and blocks like a pro
-----------------------------------------------------

Go to admin/config/content/ace-editor and configure the module for node/block editing. Then head over 
to a block or node containing a textarea with the correct text format and hack away!


Display fields using syntax highlighting
----------------------------------------------

Manage the display of any text area fields attached to a node and select the "Code syntax highlighting"
format. This outputs the content of the field as a ready-only editor, with syntax highlighting in your
node view using the selected options.


Use syntax hilighting from your template files
-----------------------------------------------------

You can use the ace_editor_add($content, $settings) function to add syntax-highlighting code display
anywhere in your template files. An optional array contains settings as shown below.


Embed code snippets in the body of your nodes or blocks
---------------------------------------------------------------

Add the syntax highlighting filter to any of your text formats. The module displays text inside an
<ace> tag as code using the custom formatting options specified as attributes to the <ace> tag.

You can override the default options by adding attributes to the <ace> tag:

Here are the possible values:

  theme
    clouds = Clouds
	clouds_midnight = Clouds Midnight
	cobalt = Cobalt
	crimson_editor = Crimson Editor
	dawn = Dawn
	idle_fingers = Idle Fingers
	kr_theme = krTheme
	merbivore = Merbivore
	merbivore_soft = Merbivore Soft
	mono_industrial = Mono Industrial
	monokai = Monokai
	pastel_on_dark = Pastel on dark
	solarized_dark = Solarized Dark
	solarized_light = Solarized Light
	textmate = TextMate
	twilight = Twilight
	tomorrow = Tomorrow
	vibrant_ink = Vibrant Ink

  syntax
    c_cpp = C/C++
	clojure = Clojure
	coffee = CoffeeScript
	csharp = C#
	css = CSS
	groovy = Groovy
	html = HTML
	java = Java
	javascript = JavaScript
	json = JSON
	ocaml = OCaml
	perl = Perl
	php = PHP
	python = Python
	scala = Scala
	scss = SCSS
	ruby = Ruby
	svg = SVG
	textile = Textile
	xml = XML

  height
      auto, 300px, 75% etc.

  width
    100%, 600px etc.

  font-size
    All compatible CSS values for font-size

  line-numbers
    1 or 0 (on/off)

  print-margin
    1 or 0 (on/off)

  invisibles
    1 or 0 (on/off)

Examples:
      <ace theme="textmate" height="200px" font-size="12pt" print-margin="1">
      <ace theme="twilight" syntax="php" height="200px" width="50%">
      <ace height="100px" width="100%" invisibles="1">
