summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNick White <git@njw.me.uk>2012-06-10 18:50:32 +0100
committerNick White <git@njw.me.uk>2012-06-10 18:50:32 +0100
commit9490f1f04b5a33be6259017ce5d33cb5c9f9ba11 (patch)
tree831cd4bdb0d7bcf87c9690e0bed4c36ec25dfea8
parent7869b4f0c4e8461ff183a33db6dd840886177106 (diff)
Add comparison webpage
-rw-r--r--Makefile18
-rw-r--r--comparison.txt19
2 files changed, 35 insertions, 2 deletions
diff --git a/Makefile b/Makefile
index 08d24aa..ac9dcbd 100644
--- a/Makefile
+++ b/Makefile
@@ -47,7 +47,7 @@ uninstall:
cd $(DESTDIR)$(MANPREFIX)/man1 && rm -f $(MAN)
clean:
- rm -f -- $(BIN) $(OBJ) util.a index.html
+ rm -f -- $(BIN) $(OBJ) util.a index.html comparison.html
dist:
mkdir -p $(NAME)-$(VERSION)
@@ -127,9 +127,23 @@ index.html: doap.ttl README
echo "$(NAME) for mac os x [available from Homebrew](http://mxcl.github.com/homebrew/)" | smu >> $@
#echo "[$(NAME) $(VERSION) windows]($(NAME)-$(VERSION)-win.zip) ([sig]($(NAME)-$(VERSION)-win.zip.sig)) ($(RELDATE))" | smu >> $@
sed '1,5d' < README | smu >> $@
+ echo "[comparison with similar programs](comparison)" | smu >> $@
echo '<hr />' >> $@
sh websummary.sh doap.ttl | smu >> $@
echo '</body></html>' >> $@
+comparison.html: comparison.txt
+ echo making comparison webpage
+ echo "<!DOCTYPE html><html><head><title>$(NAME)</title>" > $@
+ echo '<link rel="alternate" type="text/turtle" title="rdf" href="doap.ttl" />' >> $@
+ echo '<style type="text/css">' >> $@
+ echo "body {font-family:sans-serif; width:38em; margin:auto; max-width:94%;}" >> $@
+ echo "h1 {font-size:1.6em; text-align:center;}" >> $@
+ echo "a {text-decoration:none; border-bottom:thin dotted;}" >> $@
+ echo "img {margin: auto; border: thin solid; display: block;}" >> $@
+ echo "</style></head><body>" >> $@
+ smu < comparison.txt >> $@
+ echo '</body></html>' >> $@
+
.PHONY: all clean install uninstall dist dist-win dist-mac
-.SILENT: index.html dist
+.SILENT: index.html comparison.html dist
diff --git a/comparison.txt b/comparison.txt
new file mode 100644
index 0000000..5fc02ca
--- /dev/null
+++ b/comparison.txt
@@ -0,0 +1,19 @@
+# comparison with similar programs
+
+There are several programs that do similar things to [getxbook](http://njw.me.uk/software/getxbook):
+
+* [PySheng](http://code.google.com/p/pysheng/)
+* [Google Book Downloader](http://googlebookdownloader.codeplex.com/)
+* [Google Book Downloader UserScript](http://userscripts.org/scripts/show/37933)
+
+There are also several other programs which are proprietary. By forbidding the free reading, sharing and modification of their code, they deprive their users of important freedoms, and likely also spy on their reading habits. Given that a major goal of getxbook is ensuring the freedom to read, I am disqualifying these from any comparison.
+
+*Google Book Downloader* is Windows only, and depends on lots of proprietary software to run. It is also not clear whether 'preview only' availability books can be downloaded. It can convert the book pages directly into one PDF.
+
+*PySheng* is a free Python program and runs on free platforms. It's much larger and more complex (and hence likely more buggy), and less mature. It also depends on Python and GTK, which are rather slow, large, and heavy.
+
+*Google Book Downloader UserScript* is a GreaseMonkey script, which runs in Firefox. It goes without saying therefore that it has a rather significant dependency. It requires you to download one page at a time, and hence it makes the process of downloading a book very time and labour consuming.
+
+While some of the above programs offer saving to PDF, only *getxbook* offers the ability to save a book as DejaVu, or automatically OCR the pages to extract the text in them, saving it either into a text file, or embedded in a PDF or DejaVu file.
+
+The above programs are all limited to downloading from Google Books, whereas *getxbook* can download from several websites with different book databases. I am not aware of any other programs that offer this.