================================ Go Template With Gettext Support

Go_ html/template_ with gettext_ support.

Development Environment:

Ubuntu 20.04_
Go 1.14.4_

Install +++++++

.. code-block:: bash

go get -u github.com/siongui/gtmpl

Usage +++++

The gettext_ feature is provided by chai2010/gettext-go, which is pure Go solution for gettext.

Follow gettext workflow_ to prepare PO files, we need to mark translatable strings from input files. In our cases here, the translatable string Pāḷi Dictionary is marked as {{gettext "Pāḷi Dictionary"}} (see theme/template-i18n/index.html <theme/template-i18n/index.html>). If we run xgettext directly on the Go template, we get nothing [7]. We can use sed to convert the marked strings in Go template to the extractable syntax as follows:

.. code-block:: bash

$ sed "s/{{gettext (".*")}}/{{gettext(\1)}}/g" theme/template-i18n/index.html | xgettext --no-wrap --language=c --from-code=UTF-8 --output=locale/messages.pot -

Then we follow the normal workflow again to finish the translation and get the PO files to be used by chai2010/gettext-go_ package.

See parse_test.go <parse_test.go>_ for how to create HTML files.

UNLICENSE +++++++++

Released in public domain. See UNLICENSE_.

References ++++++++++

.. [1] Golang Template Inheritance (Python Jinja2 extends & include) <https://siongui.github.io/2017/02/05/go-template-inheritance-jinja2-extends-include/>_

.. [2] GitHub - chai2010/gettext-go: GNU gettext for Go <https://github.com/chai2010/gettext-go>_ (godoc <https://godoc.org/github.com/chai2010/gettext-go/gettext>__)

.. [3] io writer to string golang - Google search <https://www.google.com/search?q=io+writer+to+string+golang>_

.. [4] | godoc code - Google search <https://www.google.com/search?q=godoc+code>_ | godoctricks - GoDoc <https://godoc.org/github.com/fluhus/godoc-tricks>_

.. [5] | render_ and grender_ | grender: stdlib templates with additional "extends" support : golang <https://www.reddit.com/r/golang/comments/61hcfg/grender_stdlib_templates_with_additional_extends/>_ | GitHub - dannyvankooten/grender: Go package for easily rendering JSON/XML data and HTML templates <https://github.com/dannyvankooten/grender>_ | GitHub - unrolled/render: Go package for easily rendering JSON, XML, binary data, and HTML templates responses. <https://github.com/unrolled/render>_

.. [6] | Go template rendering or Node.js template rendering? : golang <https://www.reddit.com/r/golang/comments/68i04t/go_template_rendering_or_nodejs_template_rendering/>_ | GitHub - titpetric/egon: An ERB-style templating language for Go. <https://github.com/titpetric/egon>_ | books/12fa-docker-golang/chapter7 at master · titpetric/books · GitHub <https://github.com/titpetric/books/tree/master/12fa-docker-golang/chapter7>_

.. [7] xgettext Extract Translatable Strings From Golang html/template <https://siongui.github.io/2016/01/19/xgettext-extract-translatable-string-from-go-html-template/>_

.. _Go: https://golang.org/ .. _html/template: https://golang.org/pkg/html/template/ .. _gettext: https://www.google.com/search?q=gettext .. _Ubuntu 20.04: https://releases.ubuntu.com/20.04/ .. _Go 1.14.4: https://golang.org/dl/ .. _chai2010/gettext-go: https://github.com/chai2010/gettext-go .. _gettext workflow: https://www.google.com/search?q=gettext+workflow .. _xgettext: https://www.google.com/search?q=xgettext .. _sed: https://www.google.com/search?q=sed .. _grender: https://github.com/dannyvankooten/grender .. _render: https://github.com/unrolled/render .. _UNLICENSE: https://unlicense.org/

# README

================================ Go Template With Gettext Support