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

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

[Joseph Otakadelic]

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

Hi there,

I tried to visit zshwiki.org but nothing there. So I created one
alternative.

https://zsh.wikia.com/

Please feel free to visit / edit / add any sorts of information and
comments.

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!

- Otakadelic

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

[Daniel Shahaf]

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)

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

[gi1242+zsh]

On Thu, Sep 13, 2018 at 10:22:46PM +0900, Joseph Otakadelic wrote:

> I tried to visit zshwiki.org but nothing there. So I created one
> alternative.
> 
> https://zsh.wikia.com/

The problem with wikia is that it has un-removable ads. For open source
projects the project hosting site usually has a comparable wiki with
fewer / no ads.

GI

-- 
The Magic of Windows: Turns a Pentium into an XT.

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

[Joseph Otakadelic]

[-- 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)
>

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

[Joseph Otakadelic]

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

Oh I just didn't know that. Thanks for your information.

Does anyone know better place than wikia.com?

I checked the status of zshwiki.org domain by whois and found Mr. Bruno
Bonfils owns and I can't do nothing but create alternative if I want wiki
for zsh(and I want wiki for zsh).

- Otakadelic

On Tue, Sep 18, 2018 at 10:31 AM <gi1242+zsh@gmail.com> wrote:

> On Thu, Sep 13, 2018 at 10:22:46PM +0900, Joseph Otakadelic wrote:
>
> > I tried to visit zshwiki.org but nothing there. So I created one
> > alternative.
> >
> > https://zsh.wikia.com/
>
> The problem with wikia is that it has un-removable ads. For open source
> projects the project hosting site usually has a comparable wiki with
> fewer / no ads.
>
> GI
>
> --
> The Magic of Windows: Turns a Pentium into an XT.
>