[NaCl SDK Docs] Update CSS for docs.

[NaCl SDK Docs] Update CSS for docs.

* Add a top-level <div> with id "doxygen-ref", to more easily match only
doxygen-generated elements. This is the same behavior as with devsite.
* Also add doxygen.css, which is minimal so far; it mostly just cleans up the
table layout.
* Also removing the local_extensions.css file. It was only used for local testing make the generated pages look more like devsite.

BUG=none
R=awatson@chromium.org, sbc@chromium.org

Committed: https://src.chromium.org/viewvc/chrome?view=rev&revision=249462

[binji, 2014-02-04 01:05:31]

https://codereview.chromium.org/153333002/diff/1/native_client_sdk/src/doc/do...
File native_client_sdk/src/doc/doxygen/header.html (right):

https://codereview.chromium.org/153333002/diff/1/native_client_sdk/src/doc/do...
native_client_sdk/src/doc/doxygen/header.html:5: {{- dummy div to appease
doxygen -}}
{{- ... -}} is a comment that the chromesite doc server will ignore

[Sam Clegg, 2014-02-04 01:32:56]

lgtm,

What is that huge .css file you are deleting?

[binji, 2014-02-04 17:18:08]

I believe that is CSS that made the docs look more like devsite when serving
locally. It was never included in devsite production, and not used at all for
chromesite.

[Andy, 2014-02-04 18:50:38]

https://codereview.chromium.org/153333002/diff/1/native_client_sdk/src/doc/_s...
File native_client_sdk/src/doc/_static/css/local_extensions.css (left):

https://codereview.chromium.org/153333002/diff/1/native_client_sdk/src/doc/_s...
native_client_sdk/src/doc/_static/css/local_extensions.css:5: /* GENERAL */
Some of these styles are used on DevSite -- for example, the styles under
GENERAL and HOME PAGE.

Have you tried running a local server to see what the landing page looks like
without this CSS file?

Is it worth keeping this file around, but deleting or commenting out most of the
existing styles?  It might be nice to keep a placeholder for styles for the NaCl
doc set, so that we don't have to modify the header template later.

[binji, 2014-02-04 22:01:48]

https://codereview.chromium.org/153333002/diff/1/native_client_sdk/src/doc/_s...
File native_client_sdk/src/doc/_static/css/local_extensions.css (left):

https://codereview.chromium.org/153333002/diff/1/native_client_sdk/src/doc/_s...
native_client_sdk/src/doc/_static/css/local_extensions.css:5: /* GENERAL */
On 2014/02/04 18:50:39, Andy wrote:
> Some of these styles are used on DevSite -- for example, the styles under
> GENERAL and HOME PAGE.
> 
> Have you tried running a local server to see what the landing page looks like
> without this CSS file?

This CSS file wasn't included, but I see what you mean; the "download SDK"
button is not actually a button. I've added back in some of the CSS here in a
file called nacl.css, and added it to the "standard_nacl_article" template.

> 
> Is it worth keeping this file around, but deleting or commenting out most of
the
> existing styles?  It might be nice to keep a placeholder for styles for the
NaCl
> doc set, so that we don't have to modify the header template later.

[Andy, 2014-02-05 00:30:06]

LGTM.

A couple of small suggestions inline for styles that are safe to delete.

https://codereview.chromium.org/153333002/diff/80001/native_client_sdk/src/do...
File native_client_sdk/src/doc/_static/css/nacl.css (right):

https://codereview.chromium.org/153333002/diff/80001/native_client_sdk/src/do...
native_client_sdk/src/doc/_static/css/nacl.css:35: /* VERSION INFORMATION */
Delete styles under VERSION INFORMATION.  This applied to the left-nav on
DevSite.

https://codereview.chromium.org/153333002/diff/80001/native_client_sdk/src/do...
native_client_sdk/src/doc/_static/css/nacl.css:104: /* OLD STYLES FROM CODESITE
*/
Delete styles under "CODESITE".

[binji, 2014-02-05 01:41:44]

https://codereview.chromium.org/153333002/diff/80001/native_client_sdk/src/do...
File native_client_sdk/src/doc/_static/css/nacl.css (right):

https://codereview.chromium.org/153333002/diff/80001/native_client_sdk/src/do...
native_client_sdk/src/doc/_static/css/nacl.css:35: /* VERSION INFORMATION */
On 2014/02/05 00:30:08, Andy wrote:
> Delete styles under VERSION INFORMATION.  This applied to the left-nav on
> DevSite.

Done.

https://codereview.chromium.org/153333002/diff/80001/native_client_sdk/src/do...
native_client_sdk/src/doc/_static/css/nacl.css:104: /* OLD STYLES FROM CODESITE
*/
On 2014/02/05 00:30:08, Andy wrote:
> Delete styles under "CODESITE".

Done.

[binji, 2014-02-06 18:48:39]

Committed patchset #3 manually as r249462 (presubmit successful).