Re: Full documentation in a single document?

[vukini]

Lawrence,



Thank you! 



This is really great.



Vid



--

 

  vuk...@fastmail.com







On Tue, Dec 20, 2016, at 10:25 AM, Lindsay John Lawrence wrote:

> I took a few minutes to more sensibly organize the individual
> catenated html docs. Updated file attached.
> If you open the html in google-chrome web browser you can 'print...',
> 'save as pdf..' and get a single hyperlinked pdf.
> 

> /Lindsay

> 

> The list of files in the catenated html, in order:

> 

> toc.html

> ref.html

> refA.html

> refB.html

> refC.html

> refD.html

> refE.html

> refF.html

> refG.html

> refH.html

> refI.html

> refJ.html

> refK.html

> refL.html

> refM.html

> refN.html

> refO.html

> refP.html

> refQhtml

> refR.html

> refS.html

> refT.html

> refU.html

> refV.html

> refW.html

> refX.html

> refY.html

> refZ.html

> ref_.html

> select.html

> tut.html

> app.html

> faq.html

> native.html

> 

> 

> 

> 

> 

> On Mon, Dec 19, 2016 at 8:21 PM, Lindsay John Lawrence
>  wrote:
>> Attached is my quick 10minute solution when I wanted a doc+tutorial
>> to peruse on a long car ride.
>> 

>> # ---
>> # -
>> # Run pil static web server on /usr/lib/picolisp/doc

>> pil @lib/http.l -'server 8080 "*.html"' -wait

>> 

>> # Build an index file 'pil.txt' of the .html docs you care about and
>> # use wget to get a single html doc
>> # wget -O merged_output_file  -i
>> # list_of_references_for_the_various_htmls
>> wget -O pil.html  -i  ./pil.txt

>> 

>> #  With a little regex tinkering to adjust the hrefs and generate id
>> #  attributes, the resulting single html file, is a usable doc.
>> # ---
>> # -
>> 

>> 

>> However, with termux + picolisp on my android phone I haven't used
>> this much recently.
>> It is simple to just run local webserver against the docs folder, or
>> use (doc 'symbol) from the REPL.
>> 

>> 

>> /Lindsay

>> 

>> P.S. PicoLisp is awesome.

>> 

> Email had 1 attachment:


>  * pil.html
>   979k (text/html)

Re: Full documentation in a single document?

[František Fuka]

Putting all doc/ref*.html files into single file is almost the solution.
The result is a single file function reference readable on Kindle etc (with
working hyperlinks). I am not sure it tutorial & other docs should be in
the same file, my main problem was with ref* files being split. But it's
not hard to concatenate them.

On Mon, Dec 19, 2016 at 3:41 PM, Alexander Burger 
wrote:

> On Mon, Dec 19, 2016 at 03:11:09PM +0100, Joh-Tob Schäg wrote:
> > There is not. I talked about he same thing with Regenaxer the day before
> > yesterday.
>
> You had asked for something different, putting all doc/ref*.html files
> into a single one.
>
> - Alex
> --
> UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe
>



-- 
*-- Frantisek Fuka*
(yes, that IS my real name)

-- My Personal homepage: www.fuxoft.cz
-- My Google+ profile: google.com/+fuxoft
-- My Telegram chat: telegram.fuxoft.cz

Re: Full documentation in a single document?

[Jon Kleiser]

Hi,

This was also discussed back in August 2014, with the subject “Documentation 
again”, . . .



/Jon

> On 19. Dec, 2016, at 15:11, Joh-Tob Schäg  wrote:
> 
> There is not. I talked about he same thing with Regenaxer the day before 
> yesterday. It would be very helpfull if you did create such a script. You 
> might also think about updating the hyperlinks.
> 
> I have an idea for a long term solution but the implemenation migjt take a 
> while.
> 
> Am 19.12.2016 22:51 schrieb "František Fuka" :
> Hello,
> 
> is there a single document containing all PicoLisp documentation (including 
> the function reference), suitable e.g. for reading in Kindle? Or an existing 
> script to generate such a file?
> 
> I could stitch it together rather easily from the existing HTML docs but I 
> just want to make sure I am not doing something that's already done...
> 
> Thanks
> 
> -- 
> -- Frantisek Fuka
> (yes, that IS my real name)
> 
> -- My Personal homepage: www.fuxoft.cz
> -- My Google+ profile: google.com/+fuxoft
> -- My Telegram chat: telegram.fuxoft.cz
> 
> 

Re: Full documentation in a single document?

[Alexander Burger]

On Mon, Dec 19, 2016 at 03:11:09PM +0100, Joh-Tob Schäg wrote:
> There is not. I talked about he same thing with Regenaxer the day before
> yesterday.

You had asked for something different, putting all doc/ref*.html files
into a single one.

- Alex
-- 
UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Full documentation in a single document?

[Joh-Tob Schäg]

There is not. I talked about he same thing with Regenaxer the day before
yesterday. It would be very helpfull if you did create such a script. You
might also think about updating the hyperlinks.

I have an idea for a long term solution but the implemenation migjt take a
while.
Am 19.12.2016 22:51 schrieb "František Fuka" :

> Hello,
>
> is there a single document containing all PicoLisp documentation
> (including the function reference), suitable e.g. for reading in Kindle? Or
> an existing script to generate such a file?
>
> I could stitch it together rather easily from the existing HTML docs but I
> just want to make sure I am not doing something that's already done...
>
> Thanks
>
> --
> *-- Frantisek Fuka*
> (yes, that IS my real name)
>
> -- My Personal homepage: www.fuxoft.cz
> -- My Google+ profile: google.com/+fuxoft
> -- My Telegram chat: telegram.fuxoft.cz
>
>
>