From 7cda91c7595de54b2b877203d2063605b7ed1d31 Mon Sep 17 00:00:00 2001 From: Bill Somerville Date: Sun, 24 Apr 2016 19:45:52 +0000 Subject: [PATCH] Improve the "translatability" of some of the User Guide links To aid translators some of the links in the doc/common/links.adoc file, which is shared by all translations, have been changed to remove generic link text like "here" with the titles of the linked references. Since these are in the language of the references documents there is no need to translate these. git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6647 ab8295b8-cf94-4d9e-aec4-7959e3be5d79 --- doc/common/links.adoc | 34 ++++++++++++--------- doc/user_guide/en/logging.adoc | 9 +++--- doc/user_guide/en/settings-frequencies.adoc | 4 +-- doc/user_guide/en/vhf-features.adoc | 2 +- 4 files changed, 27 insertions(+), 22 deletions(-) diff --git a/doc/common/links.adoc b/doc/common/links.adoc index 7fc6f2a99..9a7044bf7 100644 --- a/doc/common/links.adoc +++ b/doc/common/links.adoc @@ -11,10 +11,10 @@ Example: [link] http://pskreporter.info/pskmap.html [displayed text] PSK Reporter -Perform searches from the doc root directory: C:\JTSDK-DOC\doc +Perform searches from the doc root directory: doc Search: grep -rl --exclude-dir="*\.svn" {pskreporter} . - grep -rl --exclude-dir="*\.svn" PSK Reporter . - grep -rl --exclude-dir="*\.svn" {devsvn} . + grep -rl --exclude-dir="*\.svn" PSK Reporter . + grep -rl --exclude-dir="*\.svn" {devsvn} . grep -rl --exclude-dir="*\.svn" {kvasd} . grep -rl --exclude-dir="*\.svn" {ntpsetup} . @@ -23,10 +23,18 @@ Exclude links.adoc: grep -rl --exclude-dir="*\.svn" {pskreporter} . Note(s): a). Don't forget a space then "." at the end. + b). To include links.adoc file itself, remove the brackets {} from the pattern search: -c). Look at each of the files listed to ensure the [displayed test] -still makes sense in the caption. If not, just add another link. + +c). Look at each of the files listed to ensure the [displayed text] +still makes sense in the caption. If not, just add another link. Be +aware of the translators requirements by trying to keep the displayed +text language agnostic or neutral e.g. use a proper noun like a +persons name or a document title in the language of the linked +document. Do not use plain English generic words for link text link +"here". + d). Edit lines as needed. Keeping them in alphabetic order help see dupes. //// @@ -57,19 +65,18 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes. :fmt_arrl: http://www.arrl.org/frequency-measuring-test[ARRL FMT Info] :fmt_group: https://groups.yahoo.com/neo/groups/FMT-nuts/info[FMT Group] :fmt_k5cm: http://www.k5cm.com/[FMT Event Info] -:fmt_wspr: http://www.physics.princeton.edu/pulsar/K1JT/FMT_User.pdf[here] +:fmt_wspr: http://www.physics.princeton.edu/pulsar/K1JT/FMT_User.pdf[Accurate Frequency Measurements with your WSPR Setup] :gnu_gpl: http://www.gnu.org/licenses/gpl-3.0.txt[GNU General Public License] :homepage: http://physics.princeton.edu/pulsar/K1JT/[WSJT Home Page] :hrd: http://www.hrdsoftwarellc.com/[Ham Radio Deluxe] -:jt4eme: http://physics.princeton.edu/pulsar/K1JT/WSJT-X_1.6.0_for_JT4_v7.pdf[here] +:jt4eme: http://physics.princeton.edu/pulsar/K1JT/WSJT-X_1.6.0_for_JT4_v7.pdf[Using WSJT-X for JT4 EME Operation] :jt65protocol: http://physics.princeton.edu/pulsar/K1JT/JT65.pdf[QEX] :jtalert: http://hamapps.hamspots.net[JT-ALERT-X] -:kvasd-installer: http://physics.princeton.edu/pulsar/K1JT/kv-installer.txt[here] :launchpadki7mt: https://launchpad.net/~ki7mt[KI7MT PPA's] :log4om: http://www.log4om.com[Log4OM] :msys_url: http://sourceforge.net/projects/mingwbuilds/files/external-binary-packages/[MSYS Download] :ntpsetup: http://www.satsignal.eu/ntp/setup.html[Network Time Protocol Setup] -:osx_instructions: http://physics.princeton.edu/pulsar/K1JT/OSX_Readme[here] +:osx_instructions: http://physics.princeton.edu/pulsar/K1JT/OSX_Readme[Mac OS X Install Instructions] :ppa: http://en.wikipedia.org/wiki/Personal_Package_Archive[PPA] :projsummary: http://sourceforge.net/projects/wsjt/[Project Summary] :pskreporter: http://pskreporter.info/pskmap.html[PSK Reporter] @@ -84,24 +91,21 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes. :wsprnet_activity: http://wsprnet.org/drupal/wsprnet/activity[WSPRnet Activity page] // Download Links -:cty_dat: http://www.country-files.com/cty/[here] -:hamlib3: https://dl.dropboxusercontent.com/u/4192709/Hamlib-integration-wsjtx.zip[Download] +:cty_dat: http://www.country-files.com/cty/[Amateur Radio Country Files] :jtsdk_doc: http://physics.princeton.edu/pulsar/K1JT/JTSDK-DOC.exe[Download] :jtsdk_installer: http://sourceforge.net/projects/jtsdk/files/win32/2.0.0/JTSDK-2.0.0-B2-Win32.exe/download[Download] :jtsdk_omnirig: http://sourceforge.net/projects/jtsdk/files/win32/2.0.0/base/contrib/OmniRig.zip/download[Download] :jtsdk_py: http://physics.princeton.edu/pulsar/K1JT/JTSDK-PY.exe[Download] :jtsdk_qt: http://physics.princeton.edu/pulsar/K1JT/JTSDK-QT.exe[Download] :jtsdk_vcredist: http://sourceforge.net/projects/jtsdk/files/win32/2.0.0/base/contrib/vcredist_x86.exe/download[Download] -:kvasd: http://physics.princeton.edu/pulsar/K1JT/kvasd[kvasd] :nh6z: http://www.nh6z.net/Amatuer_Radio_Station_NH6Z/Other_Peoples_Software.html[here] :omnirig: http://www.dxatlas.com/OmniRig/Files/OmniRig.zip[Download] :osx: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-Darwin.dmg[wsjtx-{VERSION}-Darwin.dmg] :svn: http://subversion.apache.org/packages.html#windows[Subversion] :win32: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-win32.exe[wsjtx-{VERSION}-win32.exe] -:wsjt_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[here] +:wsjt_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[WSJT Source Repository] :wspr_code: http://physics.princeton.edu/pulsar/K1JT/WSPRcode.exe[WSPRcode.exe] -:wspr_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/branches/wspr/[here] -:kvasd_installer: http://sourceforge.net/projects/wsjt/files/kvasd-installer/kvasd-installer-1.12.14/kvasd-installer-1.12.14.tar.gz/download[kvasd-installer] +:wspr_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/branches/wspr/[WSPR Source Repository] // MAIL-TO links :alex_efros: mailto:powerman@powerman.name[Alex Efros] diff --git a/doc/user_guide/en/logging.adoc b/doc/user_guide/en/logging.adoc index 72d0f1743..eb9625407 100644 --- a/doc/user_guide/en/logging.adoc +++ b/doc/user_guide/en/logging.adoc @@ -30,10 +30,11 @@ this station In this respect the program does not distinguish between modes, but it does differentiate between bands. -_WSJT-X_ includes a built-in +cty.dat+ file containing DXCC prefix -information. Updated files can be downloaded from {cty_dat} when -required. If an updated +cty.dat+ is present in the logs folder -and readable, it will be used in preference to the built-in one. +_WSJT-X_ includes a built-in +cty.dat+ file containing DXCC prefix +information. Updated files can be downloaded from the {cty_dat} web +site when required. If an updated +cty.dat+ is present in the logs +folder and readable, it will be used in preference to the built-in +one. The log file +wsjtx_log.adi+ is updated whenever you log a QSO from _WSJT-X_. (Keep in mind that if you erase this file you will lose all diff --git a/doc/user_guide/en/settings-frequencies.adoc b/doc/user_guide/en/settings-frequencies.adoc index 52ec72a24..2ed8e5cea 100644 --- a/doc/user_guide/en/settings-frequencies.adoc +++ b/doc/user_guide/en/settings-frequencies.adoc @@ -23,8 +23,8 @@ configuration. _Frequency Calibration_: If you have calibrated your radio using WWV or other reliable frequency references, or perhaps with the technique -described {fmt_wspr}, enter the measured values for _Intercept_ A and -_Slope_ B in the equation +described in {fmt_wspr}, enter the measured values for _Intercept_ A +and _Slope_ B in the equation Dial error = A + B*f diff --git a/doc/user_guide/en/vhf-features.adoc b/doc/user_guide/en/vhf-features.adoc index 1ff9967fa..666a628a7 100644 --- a/doc/user_guide/en/vhf-features.adoc +++ b/doc/user_guide/en/vhf-features.adoc @@ -95,7 +95,7 @@ activate automatic generation of these messages, check the box labeled _Sh_ on the main window. IMPORTANT: Thanks to G3WDG, many additional hints for using JT4 and -Echo mode on the EME path are available {jt4eme}. +Echo mode on the EME path are available in {jt4eme}. === Echo Mode