Add documentation for css source code blocks
[worg.git] / org-contrib / babel / languages / ob-doc-css.org
1 #+OPTIONS:    H:3 num:nil toc:2 \n:nil @:t ::t |:t ^:{} -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
2 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate hideblocks
3 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
4 #+TAGS:       Write(w) Update(u) Fix(f) Check(c) noexport(n)
5 #+TITLE:      CSS Source Code Blocks in Org Mode
6 #+AUTHOR:     Thomas S. Dye
7 #+EMAIL:      tsd[at]tsdye[dot]com
8 #+LANGUAGE:   en
9 #+STYLE:      <style type="text/css">#outline-container-introduction{ clear:both; }</style>
10 #+LINK_UP:    ../languages.html
11 #+LINK_HOME:  http://orgmode.org/worg/
12 #+EXPORT_EXCLUDE_TAGS: noexport
13
14 #+name: banner
15 #+begin_html
16   <div id="subtitle" style="float: center; text-align: center;">
17   <p>
18   Org Mode support for <a
19   href="http://www.w3.org/Style/CSS/Overview.en.html">Cascading Style Sheets</a>
20   </p>
21   </div>
22 #+end_html
23
24 * Template Checklist [12/12]                                       :noexport:
25   - [X] Revise #+TITLE:
26   - [X] Indicate #+AUTHOR:
27   - [X] Add #+EMAIL:
28   - [X] Revise banner source block [3/3]
29     - [X] Add link to a useful language web site
30     - [X] Replace "Language" with language name
31     - [X] Find a suitable graphic and use it to link to the language
32       web site
33   - [X] Write an [[Introduction]]
34   - [X] Describe [[Requirements%20and%20Setup][Requirements and Setup]]
35   - [X] Replace "Language" with language name in [[Org%20Mode%20Features%20for%20Language%20Source%20Code%20Blocks][Org Mode Features for Language Source Code Blocks]]
36   - [X] Describe [[Header%20Arguments][Header Arguments]]
37   - [X] Describe support for [[Sessions]]
38   - [X] Describe [[Result%20Types][Result Types]]
39   - [X] Describe [[Other]] differences from supported languages
40   - [X] Provide brief [[Examples%20of%20Use][Examples of Use]]
41 * Introduction
42 CSS is a mechanism for adding style to Web documents.
43
44 CSS can't be executed.  Org mode supports tangling of CSS source code blocks.
45 * Requirements and Setup
46
47 Emacs includes a css-mode.
48
49 There is no need to activate CSS with =org-babel-do-load-languages=.
50
51 * Org Mode Features for CSS Source Code Blocks
52 ** Header Arguments
53 There are no language-specific default values or header arguments for CSS.
54 ** Sessions
55 CSS doesn't support sessions.
56
57 ** Result Types
58 CSS source code blocks don't return results.  They exist solely for
59 tangling.