Mailing List Archive: Zope: Dev

Zope 2 documentation

Index | Next | Previous | View Threaded

mbaiju at zeomega

Oct 9, 2009, 9:22 PM

Post #1 of 8 (480 views)
Permalink

Zope 2 documentation

Hi Jens,
I was looking at Zope 2 documentation. To generate this site :
http://docs.zope.org/zope2/

we use the buildout available here, is it ?
svn://svn.zope.org/repos/main/zope2docs/trunk

So, can I remove the buildout available inside zdgbook and zope2book ?

Also it looks like this patch is required to generate it locally:
-----------------x<--------------x<-------------x<-------------
Index: buildout.cfg
===================================================================
--- buildout.cfg (revision 104937)
+++ buildout.cfg (working copy)
@@ -16,6 +16,7 @@
recipe = zc.recipe.egg
eggs =
Sphinx
+ docutils
interpreter = stxpy
scripts =
sphinx-build
Index: Makefile
===================================================================
--- Makefile (revision 104937)
+++ Makefile (working copy)
@@ -3,7 +3,7 @@

# You can set these variables from the command line.
SPHINXOPTS =
-SPHINXBUILD = sphinx-build
+SPHINXBUILD = ./bin/sphinx-build
PAPER =

# Internal variables.
-----------------x<--------------x<-------------x<-------------

May be we can pin the versions of Sphinx & docutils.

Regards,
Baiju M
_______________________________________________
Zope-Dev maillist - Zope-Dev[at]zope.org
https://mail.zope.org/mailman/listinfo/zope-dev
** No cross posts or HTML encoding! **
(Related lists -
https://mail.zope.org/mailman/listinfo/zope-announce
https://mail.zope.org/mailman/listinfo/zope )

jens at dataflake

Oct 10, 2009, 1:43 AM

Post #2 of 8 (447 views)
Permalink

Re: Zope 2 documentation [In reply to]

On Oct 10, 2009, at 06:22 , Baiju M wrote:

> Hi Jens,
> I was looking at Zope 2 documentation. To generate this
> site :
> http://docs.zope.org/zope2/
>
> we use the buildout available here, is it ?
> svn://svn.zope.org/repos/main/zope2docs/trunk

Yes.

> So, can I remove the buildout available inside zdgbook and zope2book ?

Please ask Andreas Jung, he combined the buildouts and will know which
ones an go away.

> Also it looks like this patch is required to generate it locally:

Don't now. It works for me as is. I'm just a user of those buildouts,
not the maintainer. Andreas will know more.

jens

Attachments:

smime.p7s (4.70 KB)

lists at zopyx

Oct 10, 2009, 1:49 AM

Post #3 of 8 (448 views)
Permalink

Re: Zope 2 documentation [In reply to]

Am 10.10.09 10:43, schrieb Jens Vagelpohl:
>
> On Oct 10, 2009, at 06:22 , Baiju M wrote:
>
>> Hi Jens,
>> I was looking at Zope 2 documentation. To generate this
>> site :
>> http://docs.zope.org/zope2/
>>
>> we use the buildout available here, is it ?
>> svn://svn.zope.org/repos/main/zope2docs/trunk
>
> Yes.
>
>
>> So, can I remove the buildout available inside zdgbook and zope2book ?
>
> Please ask Andreas Jung, he combined the buildouts and will know which
> ones an go away.

Baiju, I don't understand why you want to remove the ZDG and Z2 Book
from the buildout?

Andreas

Attachments:

lists.vcf (0.31 KB)

mbaiju at zeomega

Oct 10, 2009, 1:52 AM

Post #4 of 8 (447 views)
Permalink

Re: Zope 2 documentation [In reply to]

On Sat, Oct 10, 2009 at 2:19 PM, Andreas Jung <lists[at]zopyx.com> wrote:
> Am 10.10.09 10:43, schrieb Jens Vagelpohl:
>>
>> On Oct 10, 2009, at 06:22 , Baiju M wrote:
>>
>>> Hi Jens,
>>> � � � � � �I was looking at Zope 2 documentation. �To generate this
>>> site :
>>> http://docs.zope.org/zope2/
>>>
>>> we use the buildout available here, is it ?
>>> svn://svn.zope.org/repos/main/zope2docs/trunk
>>
>> Yes.
>>
>>
>>> So, can I remove the buildout available inside zdgbook and zope2book ?
>>
>> Please ask Andreas Jung, he combined the buildouts and will know which
>> ones an go away.
>
> Baiju, I don't understand why you want to remove the ZDG and Z2 Book
> from the buildout?

I mean the buildout.cfg files inside those books. It looks like
we don't use it to generate the documentation site. We
have another buildout.cfg at the toplevel.

Regards,
Baiju M
_______________________________________________
Zope-Dev maillist - Zope-Dev[at]zope.org
https://mail.zope.org/mailman/listinfo/zope-dev
** No cross posts or HTML encoding! **
(Related lists -
https://mail.zope.org/mailman/listinfo/zope-announce
https://mail.zope.org/mailman/listinfo/zope )

lists at zopyx

Oct 10, 2009, 2:02 AM

Post #5 of 8 (446 views)
Permalink

Re: Zope 2 documentation [In reply to]

Am 10.10.09 10:52, schrieb Baiju M:
> On Sat, Oct 10, 2009 at 2:19 PM, Andreas Jung <lists[at]zopyx.com> wrote:
>
>> Am 10.10.09 10:43, schrieb Jens Vagelpohl:
>>
>>> On Oct 10, 2009, at 06:22 , Baiju M wrote:
>>>
>>>
>>>> Hi Jens,
>>>> I was looking at Zope 2 documentation. To generate this
>>>> site :
>>>> http://docs.zope.org/zope2/
>>>>
>>>> we use the buildout available here, is it ?
>>>> svn://svn.zope.org/repos/main/zope2docs/trunk
>>>>
>>> Yes.
>>>
>>>
>>>
>>>> So, can I remove the buildout available inside zdgbook and zope2book ?
>>>>
>>> Please ask Andreas Jung, he combined the buildouts and will know which
>>> ones an go away.
>>>
>> Baiju, I don't understand why you want to remove the ZDG and Z2 Book
>> from the buildout?
>>
> I mean the buildout.cfg files inside those books. It looks like
> we don't use it to generate the documentation site. We
> have another buildout.cfg at the toplevel.
I think they two-level buildout configuration could be used to build the
ZDG
and Z2 book standalone..I don't care if they will disappear :-P

Andreas

Attachments:

lists.vcf (0.31 KB)

mbaiju at zeomega

Oct 10, 2009, 2:15 AM

Post #6 of 8 (446 views)
Permalink

Re: Zope 2 documentation [In reply to]

On Sat, Oct 10, 2009 at 2:32 PM, Andreas Jung <lists[at]zopyx.com> wrote:
>> I mean the buildout.cfg files inside those books. �It looks like
>> we don't use it to generate the documentation site. We
>> have another buildout.cfg at the toplevel.
> I think they two-level buildout configuration could be used to build the
> ZDG and Z2 book standalone..I don't care if they will disappear :-P

Actually I made all these changes after I send this mail.
Yeah, without waiting for reply ;)

Also I removed the 'sources' directory and moved all docs one level up.
This will shorten the URL. But now I realized that it's going
to break few URLs in these places:
http://docs.zope.org/
http://zope2.zope.org/resources/documentation

Should I revert these changes or can you give me write
access to zope2.zope.org so that I can fix it.

Also where I need to make change to fix docs.zope.org

Regards,
Baiju M
_______________________________________________
Zope-Dev maillist - Zope-Dev[at]zope.org
https://mail.zope.org/mailman/listinfo/zope-dev
** No cross posts or HTML encoding! **
(Related lists -
https://mail.zope.org/mailman/listinfo/zope-announce
https://mail.zope.org/mailman/listinfo/zope )

jens at dataflake

Oct 10, 2009, 2:18 AM

Post #7 of 8 (446 views)
Permalink

Re: Zope 2 documentation [In reply to]

On Oct 10, 2009, at 11:15 , Baiju M wrote:

> Also where I need to make change to fix docs.zope.org

I will make those. That front page is not in SVN anywhere, it's just
one file on the file system.

jens

Attachments:

smime.p7s (4.70 KB)

jens at dataflake

Oct 10, 2009, 4:37 AM

Post #8 of 8 (442 views)
Permalink

Re: Zope 2 documentation [In reply to]

On Oct 10, 2009, at 11:15 , Baiju M wrote:

> Also I removed the 'sources' directory and moved all docs one level
> up.
> This will shorten the URL. But now I realized that it's going
> to break few URLs in these places:
> http://docs.zope.org/
> http://zope2.zope.org/resources/documentation
>
> Should I revert these changes or can you give me write
> access to zope2.zope.org so that I can fix it.
>
> Also where I need to make change to fix docs.zope.org

I fixed all of those links. zope2.zope.org is cached aggressively, so
it will take a little time for the cached page to expire.

Thanks for your continuing work on those documentation resources!

jens

Attachments:

smime.p7s (4.70 KB)

Index | Next | Previous | View Threaded

Interested in having your list archived? Contact lists@gossamer-threads.com