Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Readers > Amazon Kindle > Kindle Developer's Corner

Notices

Reply
 
Thread Tools Search this Thread
Old 04-16-2013, 01:59 PM   #136
dave2008
Addict
dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.
 
Posts: 230
Karma: 183457
Join Date: Jan 2012
Device: k3G(broken), KDXG, paperwhite
Quote:
Originally Posted by eureka View Post
Another one suggestion: write user manual with the help of Sphinx and maintain it in source tree. There is a free service Read The Docs for hosting Sphinx-based documentation. It includes deep integration with GitHub and automatic update of documentation on every commit (with the help of GitHub webhook). It also compiles documentation into PDF and EPUB formats.

There are downsides, of course. It will require Python for local testing of documentation, learning of Sphinx for documentation setup and learning of reStructuredText for documentation writing (however, reStructuredText is close to Markdown).

I understand that user manual writing isn't a priority for now and GitHub wiki is pretty fine suited for current needs. Just wanted to describe one of other possible variants.

Yeah, I am also thinking of the better way to maintain user document. It will be great if we can generate PDF/EPUB and ship it within release package. I am pretty sure that there are many undocumented features in KOReader and KPV that people haven't found out yet ;p

The good side of documentation framework like Sphinx is it's in the source tree so we can take complete control over it, automate stuffs, etc. It's generaly more develper friendly.

But the down side is also it's in source tree, so other users cannot help improve it without knowing Git and Github.

I am thinking of generating PDF/EPUB from the wiki, since it's stored as markdown and can be checked out via Git. What do you think about this approach? Any better ideas?
dave2008 is offline   Reply With Quote
Old 04-16-2013, 02:45 PM   #137
eureka
but forgot what it's like
eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.eureka ought to be getting tired of karma fortunes by now.
 
Posts: 728
Karma: 2314258
Join Date: Dec 2011
Location: north (by northwest)
Device: Kindle Touch
Quote:
Originally Posted by dave2008 View Post
But the down side is also it's in source tree, so other users cannot help improve it without knowing Git and Github.
Files in Git repositories on GitHub could be fully edited with the help of web-interface only.

There is an example of this feature usage at the page about integration of ReadTheDocs with GitHub.

There are also various web-based text editors supporting editing text content from GitHub repository online without cloning to local computer (like prose.io, c9.io).

You can also evaluate number of users that already contributed to documentation on wiki and predict whether strategy of keeping status quo will change the situation

Anyway, for now source and output formats of documentation aren't so important. Content is. And nobody could document new (and forgotten) features except developers. So if current workflow is comfortable for developers, I do agree with keeping it as a base for new ways of documentation producing.
eureka is offline   Reply With Quote
 
Advertisement
Old 04-16-2013, 03:02 PM   #138
knc1
Helpdesk Junkie
knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.knc1 ought to be getting tired of karma fortunes by now.
 
knc1's Avatar
 
Posts: 6,998
Karma: 6314536
Join Date: Feb 2012
Device: Too many.
Quote:
Originally Posted by dave2008 View Post
I am thinking of generating PDF/EPUB from the wiki, since it's stored as markdown and can be checked out via Git. What do you think about this approach? Any better ideas?
Better? No way to know.
But as a hint: You can find a markdown -> html converter in the 'tools' section of: https://bitbucket.org/twobob/kual-system
knc1 is offline   Reply With Quote
Old 04-16-2013, 04:50 PM   #139
dave2008
Addict
dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.
 
Posts: 230
Karma: 183457
Join Date: Jan 2012
Device: k3G(broken), KDXG, paperwhite
oh, I completely forgot that we can edit github files online ;p That's much better.

Also thanks knc for the lua script

Just notice that transifex supports wiki markup, but not markdown or rst, though they are quite similar. I will see if we can also get the translation part working.
dave2008 is offline   Reply With Quote
Old 04-18-2013, 06:01 AM   #140
msnf
Junior Member
msnf can extract oil from cheesemsnf can extract oil from cheesemsnf can extract oil from cheesemsnf can extract oil from cheesemsnf can extract oil from cheesemsnf can extract oil from cheesemsnf can extract oil from cheesemsnf can extract oil from cheese
 
Posts: 4
Karma: 1000
Join Date: Apr 2013
Device: kindle PW
hello to all
thanks hawhill&his friends!

very nice job
i used my pdf file with koreader but icant fined any "gotopage" btn for fast navigate!
and program not support persian fonts! i copied some persian font to font folder but icant read persian document
how i add persian fonts?
msnf is offline   Reply With Quote
Old 04-18-2013, 08:42 AM   #141
thomass
Wizard
thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.
 
Posts: 1,643
Karma: 1928003
Join Date: Mar 2011
Location: Türkiye
Device: Kindle 5.3.7
Quote:
Originally Posted by msnf View Post
i used my pdf file with koreader but icant fined any "gotopage" btn for fast navigate!
https://github.com/koreader/koreader/issues?state=open

thomass is offline   Reply With Quote
Old 04-18-2013, 09:39 AM   #142
Aj74
Enthusiast
Aj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toys
 
Posts: 37
Karma: 5506
Join Date: Feb 2013
Device: Kindle Paperwhite
Excuse me, but to some of you who use Kpvbooklet have this problem?
https://github.com/koreader/koreader/issues/73
Aj74 is offline   Reply With Quote
Old 04-18-2013, 01:36 PM   #143
Carcara
Junior Member
Carcara began at the beginning.
 
Posts: 8
Karma: 10
Join Date: Apr 2013
Device: Kindle PW
Quote:
Originally Posted by Aj74 View Post
Excuse me, but to some of you who use Kpvbooklet have this problem?
https://github.com/koreader/koreader/issues/73
I think I had the same problem. My solution:
Turn reflow off
Change Render Quality from small to medium
Turn reflow on

I don't know why the Render Quality keep changing it to small when you close the document.
Carcara is offline   Reply With Quote
Old 04-18-2013, 04:02 PM   #144
dave2008
Addict
dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.dave2008 can program the VCR without an owner's manual.
 
Posts: 230
Karma: 183457
Join Date: Jan 2012
Device: k3G(broken), KDXG, paperwhite
Quote:
Originally Posted by msnf View Post
hello to all
and program not support persian fonts! i copied some persian font to font folder but icant read persian document
how i add persian fonts?
you need to manually choose the font in font menu, touch on the top of screen to invoke main menu and switch to the second tab
dave2008 is offline   Reply With Quote
Old 04-18-2013, 05:41 PM   #145
Aj74
Enthusiast
Aj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toys
 
Posts: 37
Karma: 5506
Join Date: Feb 2013
Device: Kindle Paperwhite
Quote:
Originally Posted by Carcara View Post
I think I had the same problem. My solution:
Turn reflow off
Change Render Quality from small to medium
Turn reflow on

I don't know why the Render Quality keep changing it to small when you close the document.
Thank you, the trick worked on all files but one that still does not work.
In any case, does not seem normal to do this procedure.
Aj74 is offline   Reply With Quote
Old 04-18-2013, 05:43 PM   #146
Carcara
Junior Member
Carcara began at the beginning.
 
Posts: 8
Karma: 10
Join Date: Apr 2013
Device: Kindle PW
Quote:
Originally Posted by Carcara View Post
I think I had the same problem. My solution:
Turn reflow off
Change Render Quality from small to medium
Turn reflow on

I don't know why the Render Quality keep changing it to small when you close the document.
Change Render Quality from low* to default*
Carcara is offline   Reply With Quote
Old 04-18-2013, 05:50 PM   #147
Carcara
Junior Member
Carcara began at the beginning.
 
Posts: 8
Karma: 10
Join Date: Apr 2013
Device: Kindle PW
Quote:
Originally Posted by Aj74 View Post
Thank you, the trick worked on all files but one that still does not work.
In any case, does not seem normal to do this procedure.
Yep, this is probably a bug with the Render Quality. This procedure was only the way I came up with my tests to read with reflow until this is fixed.
Try to set the Render Quality to high in this one that is still not working.
Carcara is offline   Reply With Quote
Old 04-21-2013, 07:28 AM   #148
Aj74
Enthusiast
Aj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toys
 
Posts: 37
Karma: 5506
Join Date: Feb 2013
Device: Kindle Paperwhite
Ok, the new version has solved the problem reflow:
As soon as I click reflow, koreader closes and returns to the kindle.

https://github.com/koreader/koreader/issues/73
Aj74 is offline   Reply With Quote
Old 04-21-2013, 07:30 AM   #149
Aj74
Enthusiast
Aj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toysAj74 shares his or her toys
 
Posts: 37
Karma: 5506
Join Date: Feb 2013
Device: Kindle Paperwhite
For light, you can adjust it with the buttons instead of your fingers?
Aj74 is offline   Reply With Quote
Old 04-21-2013, 04:28 PM   #150
thomass
Wizard
thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.thomass ought to be getting tired of karma fortunes by now.
 
Posts: 1,643
Karma: 1928003
Join Date: Mar 2011
Location: Türkiye
Device: Kindle 5.3.7
Quote:
Originally Posted by Aj74 View Post
Ok, the new version has solved the problem reflow
It's also really fast now
thomass is offline   Reply With Quote
Reply

Tags
application, k5 tools, kindle, launcher add-ons, lua, reader, touch

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
K5 Hacked Up Reader for epub/fb2/txt/rtf/html/pdb/etc bhaak Kindle Developer's Corner 288 10-29-2014 07:55 PM
KPV: a PDF reader for Kindle, based on muPDF, GPLv3 hawhill Kindle Developer's Corner 1031 07-31-2014 02:55 PM
html to fb2 or epub rulet Conversion 7 06-24-2012 06:54 PM
Raccoon Reader - reads ePub, fb2, fb2.zip, txt on WP7 for free Andrei_Shvydryk Reading and Management 0 10-31-2011 04:17 PM
A real PDF to epub/djvu/rtf/html software?. DsOft ePub 35 01-02-2011 04:57 PM


All times are GMT -4. The time now is 07:40 PM.


MobileRead.com is a privately owned, operated and funded community.