{"action":"created","issue":{"url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/issues/96","labels_url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/issues/96/labels{/name}","comments_url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/issues/96/comments","events_url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/issues/96/events","html_url":"https://github.com/HugoGiraudel/sass-guidelines/issues/96","id":54613655,"number":96,"title":"[Meta] Translation","user":{"login":"HugoGiraudel","id":1889710,"avatar_url":"https://avatars.githubusercontent.com/u/1889710?v=3","gravatar_id":"","url":"https://api.github.com/users/HugoGiraudel","html_url":"https://github.com/HugoGiraudel","followers_url":"https://api.github.com/users/HugoGiraudel/followers","following_url":"https://api.github.com/users/HugoGiraudel/following{/other_user}","gists_url":"https://api.github.com/users/HugoGiraudel/gists{/gist_id}","starred_url":"https://api.github.com/users/HugoGiraudel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/HugoGiraudel/subscriptions","organizations_url":"https://api.github.com/users/HugoGiraudel/orgs","repos_url":"https://api.github.com/users/HugoGiraudel/repos","events_url":"https://api.github.com/users/HugoGiraudel/events{/privacy}","received_events_url":"https://api.github.com/users/HugoGiraudel/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/labels/Translation","name":"Translation","color":"fef2c0"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":64,"created_at":"2015-01-16T19:19:11Z","updated_at":"2015-05-18T22:08:59Z","closed_at":null,"body":"Let me open this issue so that I can talk to all of you kind folks who agreed to translate the guidelines at once. If any of you have a question about anything, please feel free to ask! \r\n\r\n## How to get started\r\n\r\nAllow me to take this issue as an opportunity to repeat the process to start translating (as I said on every translation issue):\r\n\r\n1. Fork the repository on GitHub;\r\n1. Clone it on your personal workspace:  \r\n    `git clone git@github.com:USERNAME/sass-guidelines`;\r\n1. Put yourself on the `gh-pages` branch:  \r\n    `git checkout gh-pages`;\r\n1. Create a new branch called after your language:  \r\n    `git checkout -b <language>` (e.g. `es` for Spanish).\r\n1. Copy `/en/` folder and rename it after your language:  \r\n    `cp -r en/ <language>/` (e.g. `cp -r en/ es/`).\r\n1. Add an `index.md` file in this folder containing nothing but this (replace `<language>` with your language):\r\n    ```\r\n    ---\r\n    layout: default\r\n    language: <language>\r\n    ---\r\n   \r\n    {% include chapters.html %}\r\n    \r\n    ```\r\n1. Translate one file at a time. :)\r\n\r\nBe sure to rebase your branch regularly so you always have the latest version. :)\r\n\r\n## Things to know\r\n\r\n### Site title\r\n\r\nThe site title \"Sass Guidelines\" should not be translated: it will stay as is, no matter the language.\r\n\r\n### Partial translation and note prefix\r\n\r\nThe site baseline, the donate partial and the footer involve UI translations that are not part of `index.md`. To centralize all translations, I created `_data/translations.yml`. This file is structured as follow:\r\n\r\n```yml\r\nen:\r\n  donate:\r\n    content: \"If you enjoy Sass Guidelines, please consider supporting them.\"\r\n    button: \"Support Sass Guidelines\"\r\n  baseline:\r\n    content: \"An opinionated styleguide for writing sane, maintainable and scalable Sass.\"\r\n  footer:\r\n    content: \"Made with love by [Hugo Giraudel](http://hugogiraudel.com)\"\r\n  note: \"Note\"\r\n\r\n# Same for other languages\r\n```\r\n\r\nThe only thing you have to do is complete the keys for your own language. Note that `footer.content` is parsed as Markdown.\r\n\r\nNotes are prefixed by __Note &mdash;__ in the English version. The *Note* word and the dash are added through CSS. To translate this in your language, just fill in the `note` key.\r\n\r\n### Further readings\r\n\r\n*Further readings* link titles should not be translated so it is clear which language is in use on the other side of the link.\r\n\r\n### Untranslated words and expressions\r\n\r\n* Sass Guidelines (when referring to the project itself)\r\n* front end / back end (noun)\r\n* front-end / back-end (adjective)\r\n* any abbreviation as well as their expanded version (TL;DR, DOM, CSS, SCSS, KISS, DRY...)\r\n* files, folders, classes, functions, mixins, variables and placeholders names (`is-active`, `vertical-rhythm-baseline`...)\r\n* shame.scss (the file name)\r\n* Responsive Web Design\r\n* media query / media queries\r\n* placeholder\r\n\r\nFollowing terms can be or not be translated, depending on the language. Just be consistent throughout your whole copy:\r\n\r\n* magic number(s)\r\n* stylesheet(s)\r\n* map, string, bool, arglist (when referring to Sass data types)\r\n\r\n\r\n## How to sync your fork with the latest version\r\n\r\nFirst [configure a remote for your fork](https://help.github.com/articles/configuring-a-remote-for-a-fork/) if not done yet (this is a one time only operation):\r\n\r\n```\r\n$ git remote add upstream https://github.com/HugoGiraudel/sass-guidelines.git\r\n```\r\n\r\nThen [sync your fork](https://help.github.com/articles/syncing-a-fork/):\r\n\r\n```\r\n$ git fetch upstream \r\n$ git checkout gh-pages\r\n$ git merge upstream/gh-pages\r\n```\r\n\r\nLast but not least, update your branch\r\n\r\n```\r\n$ git checkout <your_branch>\r\n$ git fetch\r\n$ git rebase origin/gh-pages\r\n```\r\n\r\n## How to submit your work\r\n\r\n1. Make sure your version is up-to-date with the current `gh-pages` branch.\r\n1. Submit a [pull request](https://github.com/hugogiraudel/sass-guidelines/pulls) on GitHub.\r\n1. This is over!\r\n\r\n## Contributors\r\n\r\n* :x: Greek: @varemenos and @kmargaritis (#83)\r\n* :white_check_mark: French: @pierrechoffe (#85)\r\n* :x: Dutch: @ttomdewit and @bartveneman (#86)\r\n* :white_check_mark: Polish: @klapec and @matchabros (#87) \r\n* :white_check_mark: German: @morkro (#88)\r\n* :x: Portuguese: @magalhini, @couto, @saravieira and @eduardoboucas (#89)\r\n* :white_check_mark: Spanish: @soniar4i and @davidkpiano (#90)\r\n* :x: Italian: @srescio (#91)\r\n* :x: Czech: @pavelantolik (#92)\r\n* :white_check_mark: Russian: @grawl and @PavelDemyanenko (#97)\r\n* :white_check_mark: Chinese: @airen and @pinggod (#126)\r\n* :white_check_mark: Korean: @kimdhoe\r\n"},"comment":{"url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/issues/comments/103228163","html_url":"https://github.com/HugoGiraudel/sass-guidelines/issues/96#issuecomment-103228163","issue_url":"https://api.github.com/repos/HugoGiraudel/sass-guidelines/issues/96","id":103228163,"user":{"login":"HugoGiraudel","id":1889710,"avatar_url":"https://avatars.githubusercontent.com/u/1889710?v=3","gravatar_id":"","url":"https://api.github.com/users/HugoGiraudel","html_url":"https://github.com/HugoGiraudel","followers_url":"https://api.github.com/users/HugoGiraudel/followers","following_url":"https://api.github.com/users/HugoGiraudel/following{/other_user}","gists_url":"https://api.github.com/users/HugoGiraudel/gists{/gist_id}","starred_url":"https://api.github.com/users/HugoGiraudel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/HugoGiraudel/subscriptions","organizations_url":"https://api.github.com/users/HugoGiraudel/orgs","repos_url":"https://api.github.com/users/HugoGiraudel/repos","events_url":"https://api.github.com/users/HugoGiraudel/events{/privacy}","received_events_url":"https://api.github.com/users/HugoGiraudel/received_events","type":"User","site_admin":false},"created_at":"2015-05-18T22:08:59Z","updated_at":"2015-05-18T22:08:59Z","body":"The 7th translation of Sass Guidelines is released: this time in German by @morkro."}}