IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

[i18n] support reference line.

Browse Source 
From "3 The Format of PO Files" at
http://www.gnu.org/s/hello/manual/gettext/PO-Files.html ::

  Comment lines starting with #: contain references to the program's
  source code.

The reference comment is useful to jump to the source position.
GNU gettext tools support the reference comment. e.g.: po-mode.el binds
"s" key to "po-cycle-source-reference" that opens a source position in
a new buffer.
This commit is contained in:
Kouhei Sutou 2011-05-08 17:48:38 +09:00
parent 0d610fcff4
commit c43e9f2fef
1 changed files with 9 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
sphinx/builders/gettext.py
View File

@ -69,7 +69,10 @@ class I18nBuilder(Builder):
for node, msg in extract_messages(doctree):
if not msg in catalog:
catalog[msg] = []
catalog[msg].append(node.uid)
if node.source and node.line:
position = {"source": node.source,
"line": node.line}
catalog[msg].append(position)
class MessageCatalogBuilder(I18nBuilder):
@ -95,12 +98,14 @@ class MessageCatalogBuilder(I18nBuilder):
pofile = open(pofn, 'w', encoding='utf-8')
try:
pofile.write(POHEADER % data)
for message, uids in messages.iteritems():
for message, positions in messages.iteritems():
# message contains *one* line of text ready for translation
message = message.replace(u'\\', ur'\\'). \
replace(u'"', ur'\"')
for uid in uids:
pofile.write(u'# %s\n' % uid)
for position in positions:
source = path.relpath(position["source"], self.outdir)
line = position["line"]
pofile.write(u'#: %s:%d\n' % (source, line))
pofile.write(u'msgid "%s"\nmsgstr ""\n\n' % message)
finally:
pofile.close()