#+OPTIONS:    H:3 num:nil toc:2 \n:nil ::t |:t ^:{} -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc broken-links:nil
#+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate hideblocks
#+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
#+TAGS:       Write(w) Update(u) Fix(f) Check(c) noexport(n)
#+TITLE:      Shell Source Code Blocks in Org Mode
#+AUTHOR:     Matt Trzcinski
#+EMAIL:      matt[at]excalamus[dot]com
#+LANGUAGE:   en
#+HTML_LINK_UP:    index.html
#+HTML_LINK_HOME:  https://orgmode.org/worg/
#+EXCLUDE_TAGS: noexport

#+name: banner
#+begin_export html
<div id="subtitle" style="float: center; text-align: center;">
  <p>
    Babel shell support, including: <a href="https://www.gnu.org/software/bash/">sh</a>,
    <a href="https://www.gnu.org/software/bash/">bash</a>,
    <a href="https://www.zsh.org/">zsh</a>,
    <a href="https://fishshell.com/">fish</a>,
    <a href="https://www.grymoire.com/unix/csh.html">csh</a>,
    <a href="https://www.in-ulm.de/~mascheck/various/ash/">ash</a>,
    <a href="http://gondor.apana.org.au/~herbert/dash/">dash</a>,
    <a href="http://www.kornshell.org/">ksh</a>,
    <a href="https://www.mirbsd.org/mksh.htm">mksh</a>, and
    <a href="https://packages.qa.debian.org/p/posh.html">posh</a>.
  </p>
  <p>
    <a href="https://www.gnu.org/software/bash/">
      <img src="https://tiswww.case.edu/php/chet/img/bash-logo-web.png"/>
    </a>
    <a href="https://www.zsh.org/">zsh</a>,
      <img src="https://zsh.sourceforge.io/Images/wizard.gif"/>
    </a>
    <a href="https://fishshell.com/">fish</a>,
      <img src="https://fishshell.com/assets/img/Terminal_Logo2_CRT_Flat.png"/>
    </a>
    <a href="http://www.kornshell.org/">ksh</a>,
      <img src="http://www.kornshell.org/kornshell.gif"/>
    </a>
    <a href="https://www.mirbsd.org/mksh.htm">mksh</a>, and
      <img src="https://www.mirbsd.org/pics/logo-grey.png"/>
    </a>
  </p>
</div>
#+end_export

* Template Checklist [4/12]                                        :noexport:
  - [X] Revise #+TITLE:
  - [X] Indicate #+AUTHOR:
  - [X] Add #+EMAIL:
  - [X] Revise banner source block [3/3]
    - [X] Add link to a useful language web site
    - [X] Replace "Language" with language name
    - [X] Find a suitable graphic and use it to link to the language
      web site
  - [ ] Write an [[Introduction]]
  - [ ] Describe [[Requirements and Setup][Requirements and Setup]]
  - [ ] Replace "Language" with language name in [[Org Mode Features for Language Source Code Blocks][Babel Features for Language Source Code Blocks]]
  - [ ] Describe [[Header Arguments][Header Arguments]]
  - [ ] Describe support for [[Sessions]]
  - [ ] Describe [[Result Types][Result Types]]
  - [ ] Describe [[Other]] differences from supported languages
  - [ ] Provide brief [[Examples of Use][Examples of Use]]
* Introduction
  - Brief description of language.
  - Range of typical uses within Org Mode.
* Requirements and Setup
  - Installation and configuration of language software
  - Emacs configuration
  - Org-mode configuration (org-babel-do-load-languages)
* Babel Features for Language Source Code Blocks
** Header Arguments
   - Language-specific default values
   - Language-specific header arguments
** Sessions
   - Support or not
   - Typical use for sessions
** Result Types
   - Which result types are supported?
** Other
   - Differences from other supported languages
* Examples of Use
  - Hello World!
  - Common uses
  - Links to tutorials and other resources