switch to default rtd theme

[anarcat]

still TODO:

• add sidebar / find solution for "related links" (support request upstream) - moved to README for now
• add back the "fork me on github" link? just dropping the link for now
• consider other themes alabaster doesn't support mobile devices
• add logo - needs a new logo, should probably be moved to a different issue

the results can be seen here for now:

http://borgbackup-anarcat.readthedocs.org/en/rtfd-debug/

[anarcat]

another possible theme to consider: https://github.com/bitprophet/alabaster

for sidebars, maybe something here? http://sphinx-doc.org/config.html#confval-html_sidebars

it seems that we had custom sidebars that were shipped with our custom theme, not sure how to deal with that in the sphinx theme... maybe just move the sidebar to a new section? links.rst?

[anarcat]

for the logo: readthedocs/sphinx_rtd_theme#69 but it would need to be something else than green...

[anarcat]

sidebar issue: readthedocs/sphinx_rtd_theme#254

[codecov-io]

Current coverage is 83.13%

Merging #268 into master will not affect coverage as of a24663c

@@            master    #268   diff @@
======================================
  Files           31      31       
  Stmts         6748    6748       
  Branches         0       0       
  Methods          0       0       
======================================
  Hit           5610    5610       
  Partial          0       0       
  Missed        1138    1138       

Review entire Coverage Diff as of a24663c

---

Uncovered Suggestions

1. +0.62% via borg/fuse.py#126...167
2. +0.50% via borg/xattr.py#199...232
3. +0.43% via borg/xattr.py#166...194
4. See 7 more...

Powered by Codecov. Updated on successful CI builds.

[ThomasWaldmann]

alabaster seems to have some nice features, but is it responsive design to adapt to misc. devices / display sizes / dpi (that was one of the main reasons to move to rtd)?

"fork me on github" is not essential, we can also just drop that. developers will know anyway.

related links could be also put into README.rst, if sidebar extension isn't possible yet.

[anarcat]

On 2015-10-10 06:37:08, TW wrote:

alabaster seems to have some nice features, but is it responsive design to adapt to misc. devices / display sizes / dpi (that was one of the main reasons to move to rtd)?

i have no idea, would need to test / ask them. :)

"fork me on github" is not essential, we can also just drop that. developers will know anyway.

agreed, i don't like that badge much anyways: "fork me" seems a little
ironic considering the history of borg... ;)

related links could be also put into README.rst, if sidebar extension isn't possible yet.

okay then, maybe we can just start with that, it would be a good
addition to the README anyways.

a.

It will be a great day when our schools get all the money they need
and the air force has to hold a bake sale to buy a bomber.
- Unknown

[anarcat]

alabaster seems to have some issues with mobile for now: sphinx-doc/alabaster#57 and sphinx-doc/alabaster#44 - i'd suggest sticking with rtd for now.

[anarcat]

i have added the sidebar links to the README, i'd suggest moving the question of the logo to a separate issue for now.

otherwise this is ready to be merged, i updated my test copy with the new version:

http://borgbackup-anarcat.readthedocs.org/en/rtfd-debug/

[ThomasWaldmann]

i did a quick test on my phone (6.4" FHD), looked good!

except the travis and coverage buttons, which get huge (full width) when the window width is below some specific value.

[anarcat]

except the travis and coverage buttons, which get huge (full width) when the window width is below some specific value.

is that a blocker? :)

[ThomasWaldmann]

no

[anarcat]

so i guess i'll just merge for now and create issues for the rest