This repository has been archived on 2025-03-01. You can view files and clone it, but cannot push or open issues or pull requests.
trantor/templates/help.html
2018-07-01 14:35:22 +00:00

48 lines
2.4 KiB
HTML

{{template "header.html" .S}}
<h4>Advanced Search</h4>
<p>It is possible to search books in an specific language adding <em>lang:code</em> to the search string. See for example some searches:
<ul>
<li><a href="/search/?q=lang:en hacker">lang:en hacker</a></li>
<li><a href="/search/?q=lang:es">lang:es</a></li>
<li><a href="/search/?q=isaac asimov lang:fr">isaac asimov lang:fr</a></li>
</ul>
</p>
<p>There is other topics than <em>lang</em> that can be used:
<ul>
<li><a href="/search/?q=author:doctorow">author:doctorow</a></li>
<li><a href="/search/?q=tag:computers title:python">tag:computers title:python</a></li>
<li><a href="/search/?q=publisher:Starch">publisher:Starch</a></li>
</ul>
</p>
<h4>Other ways to access the library</h4>
<h6>OPDS</h6>
<p>The Imperial Library of Trantor has support for <a href="https://en.wikipedia.org/wiki/OPDS">OPDS</a>, witch allows you to browse and download books from any <a href="http://wiki.mobileread.com/wiki/OPDS#eBook_Reading_Software_Supporting_OPDS">ebook reading software that supports OPDS</a>. To use it just add the following url as your catalog address in your device:
<pre>{{.S.BaseURL}}/?fmt=opds</pre>
</p>
<p>In android devices works fine with <a href="http://fbreader.org/">fbreader</a> configuring <a href="https://guardianproject.info/apps/orbot/">orbot</a> to transparently proxy it's internet connection over tor.</p>
<h6>RSS</h6>
<p>With <a href="https://en.wikipedia.org/wiki/RSS">RSS</a> you can use your <a href="https://en.wikipedia.org/wiki/Comparison_of_feed_aggregators">feed reader</a> to see the lattest updates on a certain search or the news of the library. To get the RSS url of some search just click on the <img src="/img/feed.png" />.</p>
<h6>hummin</h6>
<p>For the command line geeks there is a <abbr title="command line interface">cli</abbr> client: <a href="https://gitlab.com/trantor/hummin">hummin</a></p>
<p>To install it in a debian based system (like ubuntu) just do:
<pre>
$ sudo apt-get install golang
$ sudo go get github.com/trantor-library/hummin
$ hummin
</pre>
</p>
<h6>JSON</h6>
<p>There is a JSON API for the library, with it you can write bots and other cool things like hummin.</p>
<p>You can add <code>?fmt=json</code> to almost any page on trantor and you'll get a json of the contents of the page. I'll love to hear if you do something cool with it, please tell me by email.</p>
{{template "footer.html"}}