- Now, in order to fetch the original BJCP document and build various derived and translated variants, simply run
```
make
```
Don't care about lots of warning about missing external entities (files). These are the missing translation snippets that we have to supply step by step.
- You will now find:
- The original complete styleguide in XML representation: `bjcp-2015-styleguide-orig.xml`
- The broken-down original content as category, subcategory, and "subsubcategory" snippets in the directory: `orig`
- A (partially) translated XML styleguide: `bjcp-2015-styleguide-de.xml`
- Now, you can gradually add and update translated content in the directory `de`. The structure should match `orig`. XML elements not present in the translated files will be copied from the `orig` data, when the translated styleguide will be generated. You will probably want to make use of this for the lists of "Commercial Examples", which are plain names of beer brands. Never modify XML element names or the XML structure, just edit the texts within the XML elements. Never change `id` attributes, never add `tags` or `specs` ("Vital Statistics") to the translated files, they will always be taken from the original data.
- An HTML form of the original styleguide: `bjcp-2015-styleguide-orig.html`
- An HTML form of the translated styleguide: `bjcp-2015-styleguide-de.html`
- Now, you can gradually add and update translated content:
- Do this only in the directory `de`.
- The structure should match `orig`.
- XML elements not present in the translated files will be copied from the `orig` data, when the translated styleguide will be generated. You will probably want to make use of this for the lists of "Commercial Examples", which are plain names of beer brands.
- Never modify XML element names or the XML structure, just edit the texts within the XML elements.
- Never change `id` attributes.
- Never add `tags` or `specs` ("Vital Statistics") to the translated files, they will always be taken from the original data.
- To supply your work back upstream to the repository, ...[TBD]
- To see the results of your translation work, you can re-run `make` at any time.
## Contact
...
...
@@ -50,4 +65,5 @@ Contact:
- Care about copyright questions. Add LICENSE file.
- Add Acknowledgements to all contributors.
- Implement links.
- Move to real public repo server und update text above.
- "make status" to display potentially missing translation snippets.
