[Fiware-cloud] Fw: D.12.5.2 FIWARE Installation and Administration Guides (Cloud).zip

Kenneth Nagin NAGIN at il.ibm.com
Wed Oct 5 11:54:42 CEST 2016


I spoke to Miguel about the pdf problem.  He wants us to all use the 
md2pdf tool (
https://forge.fiware.org/plugins/mediawiki/wiki/fiware/index.php/Tools_to_produce_deliverables
) to generate our pdf.

I personally and having problems with the tool,  but others are using it 
successfully.  Please try to use the tool ASAP so that we know if there 
are any additional problems.



Best Regards,

Kenneth Nagin
Ph: +972-4-8296227
Cell: 054-6976227
Fx: +972-4- 8296114
http://researcher.ibm.com/view.php?person=il-NAGIN



----- Forwarded by Kenneth Nagin/Haifa/IBM on 05/10/2016 12:49 PM -----

From:   MIGUEL CARRILLO PACHECO <miguel.carrillopacheco at telefonica.com>
To:     Kenneth Nagin/Haifa/IBM at IBMIL
Cc:     JOSE MANUEL CANTERA FONSECA 
<josemanuel.canterafonseca at telefonica.com>
Date:   05/10/2016 09:58 AM
Subject:        Re: D.12.5.2 FIWARE Installation and Administration Guides 
(Cloud).zip



Dear Kenneth,
The tool has been working with others, there must be a bug or something. 
We'll contact the support of the tool, they tend to respond quickly and 
well.
Regards,
Miguel

El 05/10/2016 a las 7:42, Kenneth Nagin escribió:
Unfortunately the tool that FIWARE recommends to use, md2pdf, does not 
work.

nagin at rcc-hrl-kvg-558:~/work/src/github.com/fiware-docker/docker-container-service/docs/userguide$ 
sudo docker run -v 
~/work/src/github.com/fiware-docker/docker-container-service:/md2pdf 
fiware/md2pdf -i /md2pdf/mkdocs_adminguide.yml -o 
/md2pdf/fdcs_adminguide.pdf

ERROR:  Pandoc died with exitcode "2" during conversion: Stack space 
overflow: current size 33632 bytes.
Use `+RTS -Ksize -RTS' to increase it.

Cover metadata not provided. Trying to generate it
Processing file [/md2pdf/docs/adminguide/admin-guide.md] ...

I tried all sorts of ways to get it to work but nothing was successful.


In the end I installed Pandoc, which worked reasonably well but it does 
not support internal links within a document, only external hyperlinks. 
 This forced me for the docker user guide to replace all internal links to 
external links.  The admin guide has other issues so I ended up using an 
online tool ( http://www.markdowntopdf.com/).  

I'm  checking with Fernando to which tool he used.  If this works great. 
 Otherwise I suppose md2pdf needs to be fixed.

Best Regards,

Kenneth Nagin
Ph: +972-4-8296227
Cell: 054-6976227
Fx: +972-4- 8296114
http://researcher.ibm.com/view.php?person=il-NAGIN






From:        MIGUEL CARRILLO PACHECO 
<miguel.carrillopacheco at telefonica.com>
To:        Kenneth Nagin/Haifa/IBM at IBMIL
Cc:        JOSE MANUEL CANTERA FONSECA 
<josemanuel.canterafonseca at telefonica.com>
Date:        04/10/2016 06:14 PM
Subject:        Re: D.12.5.2 FIWARE Installation and Administration Guides 
(Cloud).zip



Dear Kenneth, 
I took a look myself. Unfortunately I see this well below the level of 
maturity that I expected.
The "general" documents  (sort, easy to edit) were plagued with mistakes 
from it seems a rushed review of the one delivered in R4 since there are 
mentions to R4 instead of R5. I corrected them myself together with other 
details and they should be suitable for delivery. This message is not 
about them.
The blocker comes when I see the individual manuals. Overall, they are 
unacceptable and I wonder why they were sent as the final delivery.
Cloud portal installation manual- what format is this? It seems to come 
from readsthedocs. Why was it rendered like this? Please follow the 
guidelines to render from readthedocs properly
Docker installation manual -  what format is this? Render from readthedocs 
properly
Object Storage installation manual -  what format is this?
Cloud portal user manual- what format is this? It seems to come from 
readsthedocs. Why was it rendered like this? Please follow the guidelines
Docker user manual - wrong format. Render from readthedocs properly
Cloud portal installation manual -  what format is this?. Render from 
readthedocs properly
Best regards 
Miguel

El 29/09/2016 a las 16:06, Kenneth Nagin escribió:

Best Regards,

Kenneth Nagin
Ph: +972-4-8296227
Cell: 054-6976227
Fx: +972-4- 8296114
http://researcher.ibm.com/view.php?person=il-NAGIN






From:        MIGUEL CARRILLO PACHECO 
<miguel.carrillopacheco at telefonica.com>
To:        JOSE MANUEL CANTERA FONSECA 
<josemanuel.canterafonseca at telefonica.com>
Cc:        Kenneth Nagin/Haifa/IBM at IBMIL
Date:        29/09/2016 04:43 PM
Subject:        Re: D.12.5.2 FIWARE Installation and Administration Guides 
(Cloud).zip



José Manuel? 
I presume that you made a quick review and started to see wrong links and 
stopped. Theoretically this should be reviewed internally in cloud prior 
to delivery so we would always expect this clean... Jose Manuel, can you 
provide more info? I guess that you'll send a couple of examples but not 
an exhaustive list. 

El 29/09/2016 a las 14:42, Kenneth Nagin escribió:
Could you be more specific.
Which links are to R4 components?
Which pdfs are problematic?

Best Regards,

Kenneth Nagin
Ph: +972-4-8296227
Cell: 054-6976227
Fx: +972-4- 8296114
http://researcher.ibm.com/view.php?person=il-NAGIN






From:        MIGUEL CARRILLO PACHECO 
<miguel.carrillopacheco at telefonica.com>
To:        Kenneth Nagin/Haifa/IBM at IBMIL
Date:        29/09/2016 03:33 PM
Subject:        Re: D.12.5.2 FIWARE Installation and Administration Guides 
(Cloud).zip



Dear Kenneth, 
I have José Manuel's review. 
Apparently,  there are links to R4 components . Also, wrong pdf file names
User manuals look good from his point of view(my review is pending)
Regards,
Miguel
El 28/09/2016 a las 16:45, Kenneth Nagin escribió:

Best Regards,

Kenneth Nagin
Ph: +972-4-8296227
Cell: 054-6976227
Fx: +972-4- 8296114
http://researcher.ibm.com/view.php?person=il-NAGIN




-- 

Please update your address book with my new e-mail address: 
miguel.carrillopacheco at telefonica.com

----------------------------------------------------------------------
    _/          _/_/                     Miguel Carrillo Pacheco
   _/   _/     _/  _/   Telefónica       Distrito Telefónica 
  _/ _/_/_/   _/   _/   Investigación y  Edifico Oeste 1, Planta 6 
 _/   _/     _/  _/     Desarrollo       Ronda de la Comunicación S/N 
_/          _/_/                         28050 Madrid (Spain)  
                                         Tel:  (+34) 91 312 94 15    

                        e-mail: miguel.carrillopacheco at telefonica.com

Follow FIWARE on the net

                Website:  http://www.fiware.org
                Facebook: https://www.facebook.com/eu.fiware
                Twitter:  http://twitter.com/Fiware
                LinkedIn: https://www.linkedin.com/groups/FIWARE-4239932
----------------------------------------------------------------------

-- 

Please update your address book with my new e-mail address: 
miguel.carrillopacheco at telefonica.com

----------------------------------------------------------------------
    _/          _/_/                     Miguel Carrillo Pacheco
   _/   _/     _/  _/   Telefónica       Distrito Telefónica 
  _/ _/_/_/   _/   _/   Investigación y  Edifico Oeste 1, Planta 6 
 _/   _/     _/  _/     Desarrollo       Ronda de la Comunicación S/N 
_/          _/_/                         28050 Madrid (Spain)  
                                         Tel:  (+34) 91 312 94 15    

                        e-mail: miguel.carrillopacheco at telefonica.com

Follow FIWARE on the net

                Website:  http://www.fiware.org
                Facebook: https://www.facebook.com/eu.fiware
                Twitter:  http://twitter.com/Fiware
                LinkedIn: https://www.linkedin.com/groups/FIWARE-4239932
----------------------------------------------------------------------


-- 

Please update your address book with my new e-mail address: 
miguel.carrillopacheco at telefonica.com

----------------------------------------------------------------------
    _/          _/_/                     Miguel Carrillo Pacheco
   _/   _/     _/  _/   Telefónica       Distrito Telefónica 
  _/ _/_/_/   _/   _/   Investigación y  Edifico Oeste 1, Planta 6 
 _/   _/     _/  _/     Desarrollo       Ronda de la Comunicación S/N 
_/          _/_/                         28050 Madrid (Spain)  
                                         Tel:  (+34) 91 312 94 15    

                        e-mail: miguel.carrillopacheco at telefonica.com

Follow FIWARE on the net

                Website:  http://www.fiware.org
                Facebook: https://www.facebook.com/eu.fiware
                Twitter:  http://twitter.com/Fiware
                LinkedIn: https://www.linkedin.com/groups/FIWARE-4239932
----------------------------------------------------------------------



-- 

Please update your address book with my new e-mail address: 
miguel.carrillopacheco at telefonica.com

----------------------------------------------------------------------
     _/          _/_/                     Miguel Carrillo Pacheco
    _/   _/     _/  _/   Telefónica       Distrito Telefónica 
   _/ _/_/_/   _/   _/   Investigación y  Edifico Oeste 1, Planta 6 
  _/   _/     _/  _/     Desarrollo       Ronda de la Comunicación S/N 
 _/          _/_/                         28050 Madrid (Spain) 
                                          Tel:  (+34) 91 312 94 15 

                         e-mail: miguel.carrillopacheco at telefonica.com

Follow FIWARE on the net

                 Website:  http://www.fiware.org
                 Facebook: https://www.facebook.com/eu.fiware
                 Twitter:  http://twitter.com/Fiware
                 LinkedIn: https://www.linkedin.com/groups/FIWARE-4239932
----------------------------------------------------------------------


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-cloud/attachments/20161005/a57ca6b1/attachment.html>


More information about the Fiware-cloud mailing list

You can get more information about our cookies and privacy policies clicking on the following links: Privacy policy   Cookies policy