diff --git a/docs/_static/custom.css b/docs/_static/custom.css index fa608d1..231ec92 100644 --- a/docs/_static/custom.css +++ b/docs/_static/custom.css @@ -16,4 +16,50 @@ div.related { .brand { font-family: 'Ubuntu', 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; + font-size: 0.9em; +} + +div.sphinxsidebar h1, +div.sphinxsidebar h2, +div.sphinxsidebar h3, +div.sphinxsidebar h4, +div.sphinxsidebar h5, +div.sphinxsidebar h6 { + font-family: 'Ubuntu', 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; +} + +div.sphinxsidebar h3 { + margin: 30px 0 10px 0; +} + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: 'Ubuntu', 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; +} + +div.admonition p.admonition-title { + font-family: 'Ubuntu', 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif; +} + +div.sphinxsidebarwrapper { + padding: 0; +} + +div.note { + border: 0; +} + +div.admonition { + padding: 20px; +} + +.last { + margin-bottom: 0 !important; +} +pre { + padding: 6px 20px; } diff --git a/docs/_templates/sidebarintro.html b/docs/_templates/sidebarintro.html index ef4ad45..d4abd00 100644 --- a/docs/_templates/sidebarintro.html +++ b/docs/_templates/sidebarintro.html @@ -1,22 +1,24 @@

About Bonobo

- Bonobo is a data-processing toolkit for python 3.5+, with emphasis on simplicity, atomicity and testability. Oh, - and performances, too! + Bonobo is a data-processing toolkit for python 3.5+. +

+

+ It's a swiss-army knife for everyday's data.

Other Formats

- You can download the documentation in other formats as well: + Download the docs...

Useful Links

diff --git a/docs/_templates/sidebarlogo.html b/docs/_templates/sidebarlogo.html index f46896c..f1947a7 100644 --- a/docs/_templates/sidebarlogo.html +++ b/docs/_templates/sidebarlogo.html @@ -1,12 +1,12 @@

- + Bonobo

-

+

Data processing for humans.

diff --git a/docs/conf.py b/docs/conf.py index 38a6dd9..46a9b55 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -189,7 +189,7 @@ intersphinx_mapping = {'python': ('https://docs.python.org/3', None)} rst_epilog = """ .. |bonobo| replace:: **Bonobo** - + .. |longversion| replace:: v.{version} """.format( diff --git a/docs/install.rst b/docs/install.rst index 56f18ae..615e4bc 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -1,23 +1,47 @@ Installation ============ - Create an ETL project ::::::::::::::::::::: -Let's create a job. +First, install the framework: .. code-block:: shell-session $ pip install --upgrade bonobo - $ bonobo create my-etl.py + +Create a simple job: + +.. code-block:: shell-session + + $ bonobo init my-etl.py + +And let's go for a test drive: + +.. code-block:: shell-session + $ python my-etl.py -This job only uses one python file, and you can run it using the python interpreter. For bigger jobs or jobs that -relates to multiple files, you should create a python package. +Congratulations, you ran your first Bonobo ETL job. Now, you can head to :doc:`tutorial/index`. +.. note:: + + It's often best to start with a single file then move it into a project + (which, in python, needs to live in a package). + + You can read more about this topic in the :doc:`guide/packaging` section, + along with pointers on how to move this first file into an existing fully + featured python package. + + You can also avoid all the comments boilerplate by using `--bare` option + (which is a shorthand for `--template bare`): + + .. code-block:: shell-session + + $ bonobo init --bare my-bare-etl-job.py + Other installation options :::::::::::::::::::::::::: @@ -83,12 +107,12 @@ from the local clone.   $ git clone git@github.com:python-bonobo/bonobo.git $ cd bonobo $ pip install --editable . - + You can develop on this clone, but you probably want to add your own repository if you want to push code back and make pull requests. I usually name the git remote for the main bonobo repository "upstream", and my own repository "origin". .. code-block:: shell-session - + $ git remote rename origin upstream $ git remote add origin git@github.com:hartym/bonobo.git $ git fetch --all @@ -119,4 +143,3 @@ users. We're trying to look into that but energy available to provide serious support on windows is very limited. If you have experience in this domain and you're willing to help, you're more than welcome! -