summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--user_guide_src/source/documentation/index.rst79
1 files changed, 43 insertions, 36 deletions
diff --git a/user_guide_src/source/documentation/index.rst b/user_guide_src/source/documentation/index.rst
index e977566d2..43afe6fd3 100644
--- a/user_guide_src/source/documentation/index.rst
+++ b/user_guide_src/source/documentation/index.rst
@@ -8,12 +8,28 @@ Markdown or Textile, you will quickly grasp reStructuredText. The focus is
on readability, user friendliness, and an "I've got your hand, baby" feel.
While they can be quite technical, we always write for humans!
-A table of contents should always be included like the one below.
-It is created automatically by inserting the ``.. contents::``
-directive on a line by itself.
+A local table of contents should always be included like the one below.
+It is created automatically by inserting the the following:
-.. contents:: Page Contents
+::
+ .. contents::
+ :local:
+
+ .. raw:: html
+
+ <div class="custom-index container"></div>
+
+.. contents::
+ :local:
+
+.. raw:: html
+
+ <div class="custom-index container"></div>
+
+The <div> that is inserted as raw HTML is a hook for the documentation's
+JavaScript to dynamically add links to any function and method definitions
+contained in the current page.
**************
Tools Required
@@ -50,39 +66,39 @@ overlines. Other headings just use underlines, with the following hierarchy::
- for subsubsections
^ for subsubsubsections
" for subsubsubsubsections (!)
-
+
The :download:`TextMate ELDocs Bundle <./ELDocs.tmbundle.zip>` can help you
create these with the following tab triggers::
title->
-
+
##########
Page Title
##########
sec->
-
+
*************
Major Section
*************
-
+
sub->
-
+
Subsection
==========
-
+
sss->
-
+
SubSubSection
-------------
-
+
ssss->
-
+
SubSubSubSection
^^^^^^^^^^^^^^^^
-
+
sssss->
-
+
SubSubSubSubSection (!)
"""""""""""""""""""""""
@@ -99,12 +115,9 @@ ReST:
.. code-block:: rst
- .. php:class:: Some_class
-
- some_method()
- =============
+ .. class:: Some_class
- .. php:method:: some_method ( $foo [, $bar [, $bat]])
+ .. method:: some_method ( $foo [, $bar [, $bat]])
This function will perform some action. The ``$bar`` array must contain
a something and something else, and along with ``$bat`` is an optional
@@ -115,7 +128,7 @@ ReST:
:param bool $bat: whether or not to do something
:returns: FALSE on failure, TRUE if successful
:rtype: Boolean
-
+
::
$this->load->library('some_class');
@@ -131,16 +144,14 @@ ReST:
{
show_error('An Error Occurred Doing Some Method');
}
-
+
.. note:: Here is something that you should be aware of when using some_method().
For real.
-
+
See also :php:meth:`Some_class::should_do_something`
- should_do_something()
- =====================
- .. php:method:: should_do_something()
+ .. method:: should_do_something()
:returns: whether or something should be done or not
:rtype: Boolean
@@ -148,12 +159,10 @@ ReST:
It creates the following display:
-.. php:class:: Some_class
+.. class:: Some_class
-some_method()
-=============
- .. php:method:: some_method ( $foo [, $bar [, $bat]])
+ .. method:: some_method ( $foo [, $bar [, $bat]])
This function will perform some action. The ``$bar`` array must contain
a something and something else, and along with ``$bat`` is an optional
@@ -164,7 +173,7 @@ some_method()
:param bool $bat: whether or not to do something
:returns: FALSE on failure, TRUE if successful
:rtype: Boolean
-
+
::
$this->load->library('some_class');
@@ -180,16 +189,14 @@ some_method()
{
show_error('An Error Occurred Doing Some Method');
}
-
+
.. note:: Here is something that you should be aware of when using some_method().
For real.
-
+
See also :php:meth:`Some_class::should_do_something`
-should_do_something()
-=====================
- .. php:method:: should_do_something()
+ .. method:: should_do_something()
:returns: whether or something should be done or not
:rtype: Boolean