[Openstack-docs] api-ref-guide publishing

Andreas Jaeger aj at suse.com
Thu Mar 27 18:53:48 UTC 2014


On 03/27/2014 07:46 PM, Diane Fleming wrote:
> 
> 
> I've reworked the pom so all PDFs got to a single directory.

Yes, publishing should work now (in some way) - but it also generates
index.html and other files in the directory. We only want to copy over
the pdf files and nothing else. Correct?

So, two options: Only build PDF - or I update the tools that only the
PDF files are copied and not the rest.

Andreas

> Here's what will appear on these pages:
> 
> On http://api.openstack.org/api-ref-blockstorage.html -> publish
> api-site/api-ref-guides/target/docbkx/webhelp/api-ref-guides/api-ref-blocks
> torage.pdf
> On http://api.openstack.org/api-ref-compute-v2.html -> publish
> api-site/api-ref-guides/target/docbkx/webhelp/api-ref-guides/api-ref-comput
> e-v2.pdf
> On http://api.openstack.org/api-ref-compute-v2-ext.html -> publish
> api-site/api-ref-guides/target/docbkx/webhelp/api-ref-guides/api-ref-comput
> e-v2-ext.pdf
> 
> 
> and so on
> 
> 
> Diane
> ----------------------------------------------
> Diane Fleming
> Software Developer II - US
> 
> diane.fleming at rackspace.com
> Cell  512.323.6799
> Office 512.874.1260
> Skype drfleming0227
> Google-plus diane.fleming at gmail.com
> 
> 
> 
> 
> 
> 
> On 3/27/14 1:42 PM, "Andreas Jaeger" <aj at suse.com> wrote:
> 
>> On 03/27/2014 07:38 PM, Diane Fleming wrote:
>>> Andreas, 
>>>
>>> The plan is to take the generated PDFs and provide links for them on the
>>> relevant pages - I still have to add the code to add the PDF links.
>>>
>>> So on the http://api.openstack.org/api-ref-compute-v2.html page (for
>>> example), there will be a link to the api-ref-compute-v2.pdf.
>>>
>>> Does that make sense?
>>>
>>> There won't be any links on the main docs landing page to these PDFs.
>>>
>>> I can change the pom so that all the PDFs appear in the same directory
>>> (though I'm not sure how that matters for what I'm doing).
>>
>> So, api-ref-guides should only build the PDFs but no html files? And
>> then we move all the PDFs somewhere on api.openstack.org?
>>
>> Where would you publish api-ref-compute-v2.pdf? Should it go to
>> http://api.openstack.org/api-ref-compute-v2.pdf ?
>>
>> Let me give that a try...
>>
>> Andreas
>> -- 
>> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>>  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>>   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>>    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
> 
> 
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 


-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126



More information about the Openstack-docs mailing list