Make Source Code a directive for easier translation

[StanFromIreland]

Documentation

Currently

**Source code:** :source:Lib/FILE

Is the standard way of link source code, we should make this a directive .. source-code:: Lib/FILE

This will make it easier for translators as we would not have to translate the same string a hundred times.

[AA-Turner]

This feels like a tooling problem with translations rather than something to fix upstream - as you say, identical strings should just be able to have identical translations. As such I'm rather hesitant to make this change.

A

[StanFromIreland]

Any ideas as to how we would do that?

[AA-Turner]

The only experience I have of translating is editing .po files, where it is very simple (global find & replace). I'm not sure about other platforms or systems -- but we should have this discussion elsewhere than the Python issue tracker.

A