Devsite doc generation tweaks following Andy's requests.

Devsite doc generation tweaks following Andy's requests.

- Fix buggy path in Makefile and buggy template
- Don't auto-generate Yaml TOCs for now, but copy over _book.yaml with proper
  substitutions.

BUG=None
R=sbc@chromium.org

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

[Sam Clegg, 2013-11-04 21:47:26]

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_bo...
File native_client_sdk/src/doc/_book.yaml (right):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_bo...
native_client_sdk/src/doc/_book.yaml:6: - include:
/native-client/${folder}_reference_toc.yaml
What not keep template in the name of this file?

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
File native_client_sdk/src/doc/_sphinxext/devsite_builder.py (left):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:257:
create_toc_yaml_files(self.app)
Do this function doesn't exist at HEAD right now?

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
File native_client_sdk/src/doc/_sphinxext/devsite_builder.py (right):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:256:
self.info(bold('generating YAML table-of-contents... '))
Put this inside the condition below?

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:258: print('foo')
remove?

[eliben, 2013-11-04 21:53:02]

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_bo...
File native_client_sdk/src/doc/_book.yaml (right):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_bo...
native_client_sdk/src/doc/_book.yaml:6: - include:
/native-client/${folder}_reference_toc.yaml
On 2013/11/04 21:47:26, Sam Clegg wrote:
> What not keep template in the name of this file?

Good point. I'm not sure. Andy said he wants to just write this file manually,
so the only templat-y thing will remain folder and version. Do you think it
would be better to keep the _template?

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
File native_client_sdk/src/doc/_sphinxext/devsite_builder.py (left):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:257:
create_toc_yaml_files(self.app)
On 2013/11/04 21:47:26, Sam Clegg wrote:
> Do this function doesn't exist at HEAD right now?

It still exists - i do think it will be used at some point (like for the chrome
site infrastructure). Is it better to remove it and revive from git later?

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
File native_client_sdk/src/doc/_sphinxext/devsite_builder.py (right):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:256:
self.info(bold('generating YAML table-of-contents... '))
On 2013/11/04 21:47:26, Sam Clegg wrote:
> Put this inside the condition below?

Done.

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:258: print('foo')
On 2013/11/04 21:47:26, Sam Clegg wrote:
> remove?

Done.

[Sam Clegg, 2013-11-04 22:01:58]

lgtm

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_bo...
File native_client_sdk/src/doc/_book.yaml (right):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_bo...
native_client_sdk/src/doc/_book.yaml:6: - include:
/native-client/${folder}_reference_toc.yaml
On 2013/11/04 21:53:02, eliben wrote:
> On 2013/11/04 21:47:26, Sam Clegg wrote:
> > What not keep template in the name of this file?
> 
> Good point. I'm not sure. Andy said he wants to just write this file manually,
> so the only templat-y thing will remain folder and version. Do you think it
> would be better to keep the _template?

Fine with me either way.

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
File native_client_sdk/src/doc/_sphinxext/devsite_builder.py (left):

https://codereview.chromium.org/57923006/diff/1/native_client_sdk/src/doc/_sp...
native_client_sdk/src/doc/_sphinxext/devsite_builder.py:257:
create_toc_yaml_files(self.app)
On 2013/11/04 21:53:02, eliben wrote:
> On 2013/11/04 21:47:26, Sam Clegg wrote:
> > Do this function doesn't exist at HEAD right now?
> 
> It still exists - i do think it will be used at some point (like for the
chrome
> site infrastructure). Is it better to remove it and revive from git later?

If its really not used then I would remove it yes.

[eliben, 2013-11-04 22:27:30]

Committed patchset #5 manually as r232818 (presubmit successful).