Skip to content

Commit cc99f74

Browse files
committed
Doc prettiness
Add some badges on the sphinx docs and installation instructions on the README.
1 parent 5bebefb commit cc99f74

4 files changed

Lines changed: 27 additions & 2 deletions

File tree

README.rst

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ IRC Bot Behavior Bundle (IB3)
44

55
IRC bot framework using mixins to provide commonly desired functionality.
66

7-
About
8-
=====
7+
Overview
8+
========
99
The `irc`_ python library's ``irc.bot.SingleServerIRCBot`` provides a nice
1010
base for making a new bot, but there are many common tasks needed by a robust
1111
bot that it does not handle out of the box. IB3 collects some commonly desired
@@ -20,6 +20,11 @@ inheritance`_::
2020
class TestBot(SASL, SSL, DisconnectOnError, Bot):
2121
pass
2222

23+
Installation
24+
============
25+
* ``pip install ib3`` (recommended)
26+
* ``python setup.py install`` (from source distribution)
27+
2328
License
2429
=======
2530
IB3 is licensed under the `GNU GPLv3+`_ license.

doc/conf.py

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,3 +44,5 @@
4444
html_theme = 'sphinx_rtd_theme'
4545
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
4646
html_static_path = ['_static']
47+
48+
suppress_warnings = ['image.nonlocal_uri']

doc/index.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,23 @@
11
IRC Bot Behavior Bundle (IB3) Documentation
22
===========================================
33

4+
IRC bot framework using mixins to provide commonly desired functionality.
5+
6+
.. image:: https://img.shields.io/pypi/v/ib3.svg
7+
:target: https://pypi.org/project/ib3
8+
9+
.. image:: https://img.shields.io/travis/bd808/python-ib3/master.svg
10+
:target: http://travis-ci.org/bd808/python-ib3
11+
12+
.. image:: https://readthedocs.org/projects/python-ib3/badge/?version=latest
13+
:target: https://python-ib3.readthedocs.io
14+
15+
.. image:: https://img.shields.io/pypi/l/ib3.svg
16+
:target: https://github.com/bd808/python-ib3/blob/master/COPYING
17+
18+
.. image:: https://img.shields.io/github/forks/bd808/python-ib3.svg?style=social&label=Fork
19+
:target: https://github.com/bd808/python-ib3
20+
421
.. toctree::
522
:maxdepth: 2
623

setup.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@
2626
author='Bryan Davis',
2727
author_email='bd808@bd808.com',
2828
url='https://github.com/bd808/python-ib3',
29+
download_url='https://pypi.python.org/pypi/ib3',
2930
packages=setuptools.find_packages(
3031
exclude=['docs', 'tests', 'tests.*']),
3132
include_package_data=True,

0 commit comments

Comments
 (0)