On Sat, Aug 30, 2008 at 12:22 PM, Fraser Nevett <fra...@gmail.com> wrote:
> The new documentation site is great, but is currently lacking a search
> facility. I've been working on adding an embedded Google Custom
> Search, which is nearly ready and working well on my local copy.
Sphinx has a built-in search function; I just haven't exposed it yet.
That said, there's a good change the Google will beat anything we can
possibly do ourselves, so I'm looking forward to seeing what you've
come up with.
> 1. Is http://docs.djangoproject.com/ where the new docs will live
> permanently, or will they be moved to http://www.djangoproject.com/documentation/
> when they are "ready"?
The former. The 1.0 docs will live at docs.; the earlier stuff will
remain at the previous locations for posterity.
> 2. If the subdomain is being used, I assume at some point the main
> site's navigation will be updated and redirects applied to the /
> documentation/ URLs. At which point, where will the old (0.95 and
> 0.96) documentation live? Will it be moved to /en/0.95/ and /en/0.96/
> on the subdomain?
No; the old docs will stay where they are; 1.0+ will be in the new place.
> 3. Currently all the new docs are under /en/dev/. When Django 1.0 is
> released, will they be copied to /en/1.0/?
The latest docs will always be at /<lang>/dev/; versions frozen with
each release will be at /<lang>/<version>/.
Jacob
> On this occasion, why not change "New in Django development version"
> remarks to "New in this version"? That makes much more sense, since
> the docs get frozen for each version, so you know now and later this
> was new in dev/1.0/1.1...
From what i?ve heard I'd say facilities offered by Sphinx
(see http://sphinx.pocoo.org/markup/para.html#dir-versionadded)
are going to be used for this.
Regards,
--
Ramiro Morales
If you do 'make html' in the docs directory you'll get a search
facility provided by sphinx. It's just that the resulting links are
missing ".html" at the end.
Ronny
Regards,
Marc
--
--
http://www.marcfargas.com - will be finished someday.
FWIW: I have an almost finished (only needs packaging and some
documentation) reusable Django app that wraps around Google Business
Search. It's basically the same thing as the Google Custom Search
that's currently in place, only it doesn't work off an iframe and
doesn't have any ads.
The downside is that it's for pay, about $100 a year IIRC.
My app would be free anyway. If there's interest I can package and release it.
Cheers.
--
Antonio
/me raises hand :)
Yeah, I'd love to see it; if it integrates better -- the custom search
looks like shit, frankly -- it might be worth the money.
Jacob
On Tue, Sep 2, 2008 at 5:06 PM, Jacob Kaplan-Moss wrote:
> Yeah, I'd love to see it; if it integrates better -- the custom search
> looks like shit, frankly -- it might be worth the money.
See here:
http://code.unicoders.org/wiki/DjangoGoogleSearch
There's some documentation now, although this is of course not a
proper public release. I've been using this code in production for a
while now and it hasn't crashed on me yet, but of course your mileage
may vary. I've been using it in production here for about five months
now, without any major issues:
http://mytech.it/search/?q=test
HTH,
--
Antonio