#17478: Make top-level language doc files
----------------------------+----------------------------
Reporter: kcrisman | Owner:
Type: enhancement | Status: new
Priority: major | Milestone: sage-6.5
Component: translations | Keywords:
Merged in: | Authors:
Reviewers: | Report Upstream: N/A
Work issues: | Branch:
Commit: | Dependencies:
Stopgaps: |
----------------------------+----------------------------
Currently each translation/other doc that is not in English is just in a
directory of some kind without a master document. That is also sort of
true for English, except that http://sagemath.org/doc/ basically points to
`src/doc/en/website/index.html` (or the built version, rather).
However, this is going to soon make things a lot more unsustainable - see
for instance the way in which the actual Sage website is slowly growing
unmaintainable. Plus, the main doc page shouldn't just have to have a
hack in it to make a link to those directories; this should be first-
class.
My suggestions are to
* Make the website live in `common`
* Make a top-level `index.rst`, possibly auto generated, such that one
could do `sage -docbuild lang html` for a given value of `lang`, and it
would "just work" to build all doc of that language as well as an index
file, ''without'' getting rid of the option to do `sage -docbuild
lang/document html` all by itself.
I don't know if this is possible, but I think it's important for the long-
term.
--
Ticket URL: <http://trac.sagemath.org/ticket/17478>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
