How to set document title tag etc. for SEO

[Sanjay]

Hi,

I am new to sphinx. Could not find how to set the title tag, meta tag
etc. to make the site SEO friendly. Needing help.

thanks,
Sanjay

[Sanjay]

Hi,

> I am new to sphinx. Could not find how to set the title tag, meta tag
> etc. to make the site SEO friendly. Needing help.

Would appreciate some clues.

thanks,
Sanjay

[Doug Hellmann]

The title comes from the title of the document. I don't think the
default sphinx templates include a meta tag for keywords, but you
could create your own templates that do.

Doug

[Georg Brandl]

Sanjay schrieb:

There is a "meta" directive that you can use to create HTML meta tags, see
<http://docutils.sourceforge.net/docs/ref/rst/directives.html#meta>.

If you want to write this only once for all documents, see
<http://sphinx.pocoo.org/config.html#confval-rst_epilog>.

cheers,
Georg

[Sanjay]

Hi Doug & Georg,

Thanks for the useful inputs.

> The title comes from the title of the document.

As I know, the first line becomes the title. Is there a way to set
invisible titles so that more words can be injected to make it SEO
friendly?

thanks,
Sanjay

[Guenter Milde]

On 2009-05-11, Sanjay wrote:

> Hi Doug & Georg,

In Docutils, you can use the ``.. title::`` directive. See
http://docutils.sf.net/docutils/docs/ref/rst/directives.html

Günter

[Sanjay]

Hi Guenter,

> In Docutils, you can use the ``.. title::`` directive. Seehttp://docutils.sf.net/docutils/docs/ref/rst/directives.html

Thanks a lot for this input. However, I tried giving this near the top
of the document:

.. title:: Some title I want to appear

But it did not work. Wondering why. Any clues would help.

thanks,
Sanjay

[Guenter Milde]

On 2009-05-12, Sanjay wrote:

> Hi Guenter,

>> In Docutils, you can use the ``.. title::`` directive.

>> See http://docutils.sf.net/docutils/docs/ref/rst/directives.html

> Thanks a lot for this input. However, I tried giving this near the top
> of the document:

> .. title:: Some title I want to appear

> But it did not work. Wondering why. Any clues would help.

Seems to be one of the Docutils <-> Sphinx incompatibilities. Consider
filing an enhancement request.

Günter

[Georg Brandl]

Sanjay schrieb:

It seems I've not included this in Sphinx -- I'll try to get it working.

Georg

[Sanjay]

> Seems to be one of the Docutils <-> Sphinx incompatibilities. Consider
> filing an enhancement request.

It is here:

http://bitbucket.org/birkenfeld/sphinx/issue/173/implementing-title-directive-in-sphinx

thanks,
Sanjay

[Sanjay]

> It is here:
>
> http://bitbucket.org/birkenfeld/sphinx/issue/173/implementing-title-d...
>

Thanks for so quick resolution. It works nicely except for one thing -
now the titles are coming as link text for "Previous Page," "Next
page," and on the breadcrumb, which is quite inconvenient as I am
using long titles for SEO.

I tried customizing the link text in the toctree directive, but it did
not help.

Would need help again.

thanks,
Sanjay

[Sanjay]

> >http://bitbucket.org/birkenfeld/sphinx/issue/173/implementing-title-d...
>
> Thanks for so quick resolution. It works nicely except for one thing -
> now the titles are coming as link text for "Previous Page," "Next
> page," and on the breadcrumb, which is quite inconvenient as I am
> using long titles for SEO.
>
> I tried customizing the link text in the toctree directive, but it did
> not help.

Seems like a bug needing to be resolved before the ..title:: directive
can be actually useful. Seeking attention...

thanks,
Sanjay
http://www.sanjaypatel.name

[Sanjay]

Made a ticket for this:

http://bitbucket.org/birkenfeld/sphinx/issue/189

thanks,
Sanjay
http://www.sanjaypatel.name