Skip to content

CONTRIBUTING.md : adds detail around internal linking for translations#356

Merged
jnewbery merged 1 commit intobitcoinops:masterfrom
bitschmidty:2020-02-26-contrib-translation-anchors
Feb 26, 2020
Merged

CONTRIBUTING.md : adds detail around internal linking for translations#356
jnewbery merged 1 commit intobitcoinops:masterfrom
bitschmidty:2020-02-26-contrib-translation-anchors

Conversation

@bitschmidty
Copy link
Contributor

@bitschmidty bitschmidty commented Feb 26, 2020

Closes #354

@bitschmidty bitschmidty added the internationalization Making the site appropriate for multiple localizations label Feb 26, 2020
@bitschmidty bitschmidty self-assigned this Feb 26, 2020
Copy link
Contributor

@jnewbery jnewbery left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Mike!

CONTRIBUTING.md Outdated
- For blog posts, place the file in `_posts/<language code>/`
- Set the `lang` field to `<language code>`
- Append `-<language code>` to both the `slug` and `name` fields
- When linking internally, link to the appropriate translation, if one is available.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/linking internally/linking to material on the Optech site/ for clarity.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed.

CONTRIBUTING.md Outdated
- When linking to a specific header/bullet within a page, #anchor links are [automatically generated](https://github.com/bitcoinops/bitcoinops.github.io/blob/master/_plugins/auto-anchor.rb).
- Due to [limitations](https://github.com/bitcoinops/bitcoinops.github.io/pull/349)
in the automatic anchoring process, some languages [need HTML comments
inserted](https://github.com/bitcoinops/bitcoinops.github.io/commit/4e450d1a1f72219ec50ad91edae605647164d25d#diff-435f99f277721eff9e2f244149575f41R41)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest "some languages need HTML comments inserted. See for example the <!--1--> comment in this Japanese newsletter." to be absolutely clear about what you're demonstrating in the link.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that’s clearer, thanks for the suggestion. Changed.

@bitschmidty bitschmidty force-pushed the 2020-02-26-contrib-translation-anchors branch from 0296c51 to e0f3e91 Compare February 26, 2020 18:02
CONTRIBUTING.md Outdated
- Due to [limitations](https://github.com/bitcoinops/bitcoinops.github.io/pull/349)
in the automatic anchoring process, some languages need HTML comments
inserted into the header/bullet to ensure a unique anchor is generated.
For example, see the <!--1--> [comment](https://github.com/bitcoinops/bitcoinops.github.io/commit/4e450d1a1f72219ec50ad91edae605647164d25d#diff-435f99f277721eff9e2f244149575f41R41)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oops. Looks like this comment is commented out in the markdown. I think you can surround it with backticks to get it to display.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missed that you’re right. Fixup commit pushed.

@bitschmidty bitschmidty force-pushed the 2020-02-26-contrib-translation-anchors branch from e0f3e91 to 9616015 Compare February 26, 2020 18:19
@jnewbery jnewbery merged commit 152da3b into bitcoinops:master Feb 26, 2020
@jnewbery
Copy link
Contributor

Thanks Schmidty

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internationalization Making the site appropriate for multiple localizations

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update CONTRIBUTING notes to explain how to make non-duplicate anchor tags for non-ASCII languages

2 participants