Re: created zsh.wikia.com and epub format of zsh v.5.6.1 manual

[Joseph Otakadelic <otakadelic.zsh@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2284 bytes --]

Sorry for this delayed reply. It was just before my business trip and no
time to explain.
Now I'm back home and finally have a time to write detailed descriptions.

What I did was using calibre ebook management opensource suite.

https://calibre-ebook.com/about

It has convert function and one of supported format is zipped HTML files.
The conversion was almost default except the output epub is ver.3 format,
not ver.2 which is default.

So creating epub was super easy (at least who familiar with calibre)
however, I found unnecessary elements while I read with my phone.
I removed following parts from original html files. I would like to upload
nice and neat zsh script here but the truth is done one by one using
Notepad++ on windows 10. (Notepad++ has a function to apply regex replace
to all files on specified folder(s)).

-------------------
<table class="header" [\s\S]*?</table>
-------------------
<hr>
-------------------
<p><font size="-1">
  This document was generated on <em>September 8, 2018</em> using <a href="
http://www.gnu.org/software/texinfo/"><em>texi2any</em></a>.
</font></p>

The first one is navigation table which is better not to have because the
screen of (my) phone is not large enough.
The second and the third are more of my preference. Some people may or may
not care with these parts.

I noticed the most recent version now is 5.6.2 so will do above again. I am
sure that zsh can do this. I hope I can make this more automatic before
next major update.

Hope this will help someone who try to learn zsh!

- Otakadelic


On Fri, Sep 14, 2018 at 5:56 AM Daniel Shahaf <d.s@daniel.shahaf.name>
wrote:

> Joseph Otakadelic wrote on Thu, 13 Sep 2018 22:22 +0900:
> > I also created epub format of zsh Manual. You can download from here.
> >
> >
> http://www.mediafire.com/file/1lpn1rp28l33g73/ZShellManual.v.5.6.1.epub/file
> >
> > Hope these materials will help you!
>
> I don't know the state of the wiki, but thanks for sharing that epub
> manual.  Could you also share the steps for generating it?  They'll be
> useful to people who want to generate epub manuals of older/newer
> shell versions.
>
> Maybe it's just "Run pdf2epub(1) on the pdf manual", but that'd still be
> nice to know.
>
> Cheers,
>
> Daniel
> (I made up that command name)
>