Responsive theme for EclipseBook.in

In case if you noticed, the theme in http://eclipsebook.in/ has just been updated. (Responsive, bootstrap based theme).The theme is a customisation of https://github.com/ryan-roemer/sphinx-bootstrap-theme/. (EclipseBook.in is not yet updated with this information, but soon will be.)

There may be some rough edges in EclipseBook.in. If something is broken, or can be made better, feel free to share your thoughts.

 

Updated jQuery to use Google CDN

Just updated http://eclipsebook.in/ to use jQuery from Google CDN

As of now, I don’t know how much difference would it make to end user. But I am just crossing my fingers that it does not break anything.  Do send me message, if you find anything broken.

By the way, if any one of you want to do the same on your sphinx page, I am sharing the patch/quick hack for the html template.

 

{%- if not embedded -%}
<script type=”text/javascript”>var DOCUMENTATION_OPTIONS = {URL_ROOT: ‘{{ url_root }}’,VERSION: ‘{{ release|e }}’,COLLAPSE_INDEX: false,FILE_SUFFIX: ‘{{ ” if no_search_suffix else file_suffix }}’,HAS_SOURCE: {{ has_source|lower }}};</script>
+<script type=”text/javascript” src=”http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js”></script>
{%- for scriptfile in script_files -%}
+{%- if scriptfile != ‘_static/jquery.js’ -%}
<script type=”text/javascript” src=”{{ pathto(scriptfile, 1) }}”></script>
+{%- endif -%}
{%- endfor -%}


Professional Book like structure with Sphinx

Initially, Sphinx was designed to generate Python documentation. But, it can also be used for many things. I am currently using it to write my own book @eclipsebook.in. The advantage for me is that I can write my book in reStructuredText and can generate different formats with ease.

Here is an insight how I am tweaking/using sphinx.

Continue reading Professional Book like structure with Sphinx