diff --git a/README.rst b/README.rst index 54e069ae4..f7327f0ac 100644 --- a/README.rst +++ b/README.rst @@ -1,5 +1,5 @@ What is BorgBackup? -------------------- +=================== BorgBackup (short: Borg) is a deduplicating backup program. Optionally, it supports compression and authenticated encryption. @@ -15,7 +15,7 @@ downloaded Borg, ``docs/installation.rst`` to get started with Borg. .. _installation manual: https://borgbackup.readthedocs.org/installation.html Main features -~~~~~~~~~~~~~ +------------- **Space efficient storage** Deduplication based on content-defined chunking is used to reduce the number of bytes stored: each file is split into a number of variable length chunks @@ -82,7 +82,7 @@ Main features Easy to use -~~~~~~~~~~~ +----------- Initialize a new backup repository and create a backup archive:: $ borg init /mnt/backup @@ -105,12 +105,30 @@ Now doing another backup, just to show off the great deduplication:: For a graphical frontend refer to our complementary project `BorgWeb `_. +Links +===== + + * `Main Web Site `_ + * `Releases `_ + * `PyPI packages `_ + * `ChangeLog `_ + * `GitHub `_ + * `Issue Tracker `_ + * `Bounties & Fundraisers `_ + * `Mailing List `_ + * `License `_ + +Related Projects +---------------- + + * `BorgWeb `_ + * `Atticmatic `_ + * `Attic `_ Notes ----- -Borg is a fork of `Attic `_ and maintained by -"`The Borg collective`_". +Borg is a fork of `Attic`_ and maintained by "`The Borg collective`_". .. _The Borg collective: https://borgbackup.readthedocs.org/authors.html @@ -120,20 +138,16 @@ considerations regarding project goals and policy of the Borg project. BORG IS NOT COMPATIBLE WITH ORIGINAL ATTIC. EXPECT THAT WE WILL BREAK COMPATIBILITY REPEATEDLY WHEN MAJOR RELEASE NUMBER CHANGES (like when going from 0.x.y to 1.0.0). Please read the -`changelog`_ (or ``CHANGES.rst`` in the source distribution) for more +`ChangeLog`_ (or ``CHANGES.rst`` in the source distribution) for more information. -.. _changelog: https://borgbackup.readthedocs.org/changes.html - NOT RELEASED DEVELOPMENT VERSIONS HAVE UNKNOWN COMPATIBILITY PROPERTIES. THIS IS SOFTWARE IN DEVELOPMENT, DECIDE YOURSELF WHETHER IT FITS YOUR NEEDS. -Borg is distributed under a 3-clause BSD license, see `the license`_ +Borg is distributed under a 3-clause BSD license, see `License`_ for the complete license. -.. _the license: https://borgbackup.readthedocs.org/authors.html#license - |build| |coverage| .. |build| image:: https://travis-ci.org/borgbackup/borg.svg diff --git a/docs/_themes/local/sidebarlogo.html b/docs/_themes/local/sidebarlogo.html deleted file mode 100644 index 20ecf4108..000000000 --- a/docs/_themes/local/sidebarlogo.html +++ /dev/null @@ -1,5 +0,0 @@ - diff --git a/docs/_themes/local/sidebarusefullinks.html b/docs/_themes/local/sidebarusefullinks.html deleted file mode 100644 index c9ae280b2..000000000 --- a/docs/_themes/local/sidebarusefullinks.html +++ /dev/null @@ -1,20 +0,0 @@ -Fork me on GitHub - -

Useful Links

- - -

Related Projects

- - diff --git a/docs/_themes/local/static/favicon.ico b/docs/_themes/local/static/favicon.ico deleted file mode 100644 index 5db148ff4..000000000 Binary files a/docs/_themes/local/static/favicon.ico and /dev/null differ diff --git a/docs/_themes/local/static/local.css_t b/docs/_themes/local/static/local.css_t deleted file mode 100644 index ca5ce577e..000000000 --- a/docs/_themes/local/static/local.css_t +++ /dev/null @@ -1,173 +0,0 @@ -@import url("basic.css"); -@import url(//fonts.googleapis.com/css?family=Black+Ops+One); - -body { - font-family: Arial, Helvetica, sans-serif; - background-color: black; - margin: 0; - padding: 0; - position: relative; -} - -div.related { - display: none; - background-color: black; - padding: .4em; - width: 800px; - margin: 0 auto; -} - -div.related a { - color: white; - text-decoration: none; -} - -div.document { - width: 1030px; - margin: 0 auto; -} - -div.documentwrapper { - float: right; - width: 760px; - padding: 0 20px 20px 20px; - color: #00cc00; - background-color: #000000; - margin-bottom: 2em; -} - -div.sphinxsidebar { - margin-left: 0; - padding-right: 20px; - width: 230px; - background: #081008; - position: absolute; - top: 0; - min-height: 100%; -} - -h1, h2, h3 { - font-weight: normal; - color: #33ff33; -} - -h1 { - margin: .8em 0 .5em; - font-size: 200%; -} - -h2 { - margin: 1.2em 0 .6em; - font-size: 140%; -} - -h3 { - margin: 1.2em 0 .6em; - font-size: 110%; -} - -ul { - padding-left: 1.2em; - margin-bottom: .3em; -} - -ul ul { - font-size: 95%; -} - -li { - margin: .1em 0; -} - -a:link { - color: #dddd00; - text-decoration: none; -} - -a:visited { - color: #990000; - text-decoration: none; -} - -a:hover { - color: #dd0000; - border-bottom: 1px dotted #dd0000; -} - -div.sphinxsidebar a:link, div.sphinxsidebar a:visited { - border-bottom: 1px dotted #555; -} - -div.sphinxsidebar { - color: #00cc00; - background: 0000000; -} - -div.sphinxsidebar input { - color: #00ff00; - background: 0000000; - border: 1px solid #444444; -} - -pre { - padding: 10px 20px; - background: #101010; - color: #22cc22; - line-height: 1.5em; - border-bottom: 2px solid black; -} - -pre a:link, -pre a:visited { - color: #00b0e4; -} - -div.sidebarlogo .title { - font-family: 'Black Ops One', cursive; - font-size: 500%; -} - -div.sidebarlogo a { - color: #00dd00; -} - -div.sidebarlogo .subtitle { - font-style: italic; - color: #777; -} - -tt span.pre { - font-size: 110%; -} - -dt { - font-size: 95%; -} - -div.admonition p.admonition-title + p { - display: inline; -} - -div.admonition p { - margin-bottom: 5px; -} - -p.admonition-title { - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -div.note { - background-color: #002211; - border-bottom: 2px solid #22dd22; -} - -div.seealso { - background-color: #0fe; - border: 1px solid #0f6; - border-radius: .4em; - box-shadow: 2px 2px #dd6; -} diff --git a/docs/_themes/local/theme.conf b/docs/_themes/local/theme.conf deleted file mode 100644 index 03505a6ec..000000000 --- a/docs/_themes/local/theme.conf +++ /dev/null @@ -1,6 +0,0 @@ -[theme] -inherit = basic -stylesheet = local.css -pygments_style = tango - -[options] diff --git a/docs/conf.py b/docs/conf.py index eba5c841e..66436c171 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -19,6 +19,8 @@ sys.path.insert(0, os.path.abspath('..')) from borg import __version__ as sw_version +on_rtd = os.environ.get('READTHEDOCS', None) == 'True' + # -- General configuration ----------------------------------------------------- # If your documentation needs a minimal Sphinx version, state it here. @@ -92,7 +94,11 @@ pygments_style = 'sphinx' # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. -html_theme = 'local' +#html_theme = '' +if not on_rtd: # only import and set the theme if we're building docs locally + import sphinx_rtd_theme + html_theme = 'sphinx_rtd_theme' + html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the