Skip to content

Commit

Permalink
updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
pri22296 committed Jan 7, 2017
1 parent dd0c6cc commit 7ab1eb1
Show file tree
Hide file tree
Showing 4 changed files with 44 additions and 28 deletions.
43 changes: 35 additions & 8 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,27 @@
Example
-------
##########################################################################
ASCII Table Library for Python 3
##########################################################################

**************************************************************************
Introduction
**************************************************************************

This Package provides BeautifulTable class for easily printing
tabular data in a visually appealing ASCII format to consoles.

Features include:

* Full customization of the look and feel of the Table
* Build the Table as you wish, By adding Rows, or by columns or using
both method together.

*************************************************************************
Quickstart
*************************************************************************

-------------------------------------------------------------------------
Building the Table
-------------------------------------------------------------------------

Let's see BeautifulTable in action.

Expand Down Expand Up @@ -46,8 +68,9 @@ Now lets move on to see some common use cases. Note that not all features
are described here. See the API Documentation to get a detailed
look at all the features.

-------------------------------------------------------------------------
Accessing Rows
--------------
-------------------------------------------------------------------------

You can access a row using it's index. It works
just like a python list.
Expand All @@ -71,8 +94,9 @@ just like a python list.
| Michael | 3 | boy | 2011 |
+----------+------+--------+------+

-------------------------------------------------------------------------
Accessing Columns
-----------------
-------------------------------------------------------------------------

Columns can be accessed using their header names.
But since name of headers can be duplicated, There are
Expand Down Expand Up @@ -104,8 +128,9 @@ PLAN : Make setter only applicable for modifying. That should be a better design
| Michael | 3 | boy |
+----------+------+--------+

-------------------------------------------------------------------------
Searching for rows and columns headers
--------------------------------------
-------------------------------------------------------------------------

Cheking if a header is in the table.

Expand All @@ -117,8 +142,9 @@ Cheking if a row is in table
>>> ["Ethan", 2, "boy"] in table
True

-------------------------------------------------------------------------
Sorting
-------
-------------------------------------------------------------------------

You can also sort the table based on a column by
specifeing it's index or it's header. <-PLAN
Expand All @@ -137,8 +163,9 @@ specifeing it's index or it's header. <-PLAN
| Michael | 3 | boy |
+----------+------+--------+

-------------------------------------------------------------------------
Slicing
-------
-------------------------------------------------------------------------

Slicing creates a new table with it's own copy of data.
But it retains the properties of the original object.
Expand All @@ -157,4 +184,4 @@ But it retains the properties of the original object.

You can do much more with TablePrinter but this much should give you a
good start. Those of you who are interested to have more control can
read the API Documentation at <INSERT LINK HERE>.
read the API Documentation.
1 change: 0 additions & 1 deletion docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,6 @@
'sphinx.ext.coverage',
'sphinx.ext.ifconfig',
'sphinx.ext.viewcode',
'sphinx.ext.githubpages',
'sphinx.ext.napoleon']

napoleon_google_docstring = False
Expand Down
1 change: 0 additions & 1 deletion docs/include_readme.rst

This file was deleted.

27 changes: 9 additions & 18 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,34 +2,25 @@
sphinx-quickstart on Sun Dec 18 15:59:32 2016.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
##########################################
Welcome to beautifultable's documentation!
==========================================

Introduction
------------
##########################################

This Package provides BeautifulTable class for easily printing
tabular data in a visually appealing ASCII format to consoles.
.. include:: ../README.rst

Features include:

* Full customization of the look and feel of the Table
* Build the Table as you wish, By adding Rows, or by columns or using
both method together.

##########################################
Contents
--------
##########################################

.. toctree::
:maxdepth: 2

include_readme




##########################################
Indices and tables
------------------
##########################################

* :ref:`genindex`
* :ref:`modindex`
Expand Down

0 comments on commit 7ab1eb1

Please sign in to comment.