From dee89aed0838523b0da39a1fc07a209f469b1ddf Mon Sep 17 00:00:00 2001 From: rubenwardy Date: Fri, 22 Jul 2022 04:33:34 +0100 Subject: [PATCH] Enable Malay and French translations --- README.md | 14 +-- _data/languages.yml | 7 ++ _data/locale/en/index.yml | 2 +- _includes/navbar.html | 2 +- _layouts/default.html | 3 +- _layouts/homepage.html | 31 +++--- fr/get_involved.md | 83 ++++++++++++++++ fr/help/faq.md | 201 ++++++++++++++++++++++++++++++++++++++ fr/index.html | 4 + ms/get_involved.md | 83 ++++++++++++++++ ms/help/faq.md | 201 ++++++++++++++++++++++++++++++++++++++ ms/index.html | 4 + 12 files changed, 611 insertions(+), 24 deletions(-) create mode 100644 fr/get_involved.md create mode 100644 fr/help/faq.md create mode 100644 fr/index.html create mode 100644 ms/get_involved.md create mode 100644 ms/help/faq.md create mode 100644 ms/index.html diff --git a/README.md b/README.md index e797208..fadd130 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,11 @@ License: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) ## Translating -1. Find your two letter locale code. Should be the same as the weblate code. -2. Copy `_data/en` to `_data/LOCALE`. -3. Copy `en` to `LOCALE`. -4. Add your language to `_data/languages.yml`. -5. Translate the files in `_data/LOCALE`. -6. Translate any markdown (.md) files in `LOCALE`. +Use [Weblate](https://weblate.rubenwardy.com/projects/renewed-tab/website/) + +### Updating translations + +1. Copy `en` to `LOCALE`. +2. Delete any `redirect_from`. +3. Add your language to `_data/languages.yml`. +4. Translate any markdown (.md) files in `LOCALE`. diff --git a/_data/languages.yml b/_data/languages.yml index f6d9020..b08b93e 100644 --- a/_data/languages.yml +++ b/_data/languages.yml @@ -1,4 +1,11 @@ - name: English code: en + - name: Español code: es + +- name: Français + code: fr + +- name: Bahasa Melayu + code: ms diff --git a/_data/locale/en/index.yml b/_data/locale/en/index.yml index ae7d6cb..dc21064 100644 --- a/_data/locale/en/index.yml +++ b/_data/locale/en/index.yml @@ -81,7 +81,7 @@ features.locale.desc: | Help Translate -features.privacy.title: Privacy Orientated +features.privacy.title: Privacy Oriented features.privacy.desc: | We require only minimal permissions; other permissions are optional and only requested when needed. All your diff --git a/_includes/navbar.html b/_includes/navbar.html index d3d9d68..523ce2d 100644 --- a/_includes/navbar.html +++ b/_includes/navbar.html @@ -9,7 +9,7 @@
{% unless include.hide_brand %} - {{ l.index.title }} + {{ l.index.title | default: en.title }} {% endunless %} {% else %} @@ -14,7 +15,7 @@ {{ page.title }} {% if page.title != l.index.title %} - - {{ l.index.title }} + - {{ l.index.title | default: en.title }} {% endif %} diff --git a/_layouts/homepage.html b/_layouts/homepage.html index 6b512dd..5810d61 100644 --- a/_layouts/homepage.html +++ b/_layouts/homepage.html @@ -17,9 +17,9 @@ layout: default
-

{{ l.index.title }}

+

{{ l.index.title | default: en.title }}

- {{ l.index.description }} + {{ l.index.description | default: en.description }}

@@ -27,7 +27,7 @@ layout: default - {{ l.index.firefox }} + {{ l.index.firefox | default: en.firefox }} @@ -35,11 +35,11 @@ layout: default - {{ l.index.chrome }} + {{ l.index.chrome| default: en.chrome }} - {{ l.index.online }} + {{ l.index.online | default: en.online }}
@@ -66,7 +66,7 @@ layout: default {% assign title_id = "features." | append: item.id | append: ".title" %} {% assign desc_id = "features." | append: item.id | append: ".desc" %} {% assign title = l.index[title_id] | default: en[title_id] %} - {% assign desc = l.index[desc_id] | default: en[title_id] %} + {% assign desc = l.index[desc_id] | default: en[desc_id] %} {% capture side %}{% cycle "left", "right" %}{% endcapture %} @@ -87,7 +87,7 @@ layout: default {% endfor %}

- {{ l.index.andmore }} + {{ l.index.andmore | default: en.andmore }}

@@ -109,7 +109,7 @@ layout: default

- {{ l.index.widgets }} + {{ l.index.widgets | default: en.widgets }}

    @@ -126,7 +126,7 @@ layout: default
    @@ -155,10 +155,11 @@ layout: default

    - {{ l.index.testimonials }} + {{ l.index.testimonials | default: en.testimonials }}

    - {% for test in l.testimonials %} + {% assign testimonials = l.testimonials | default: site.data.locale.en.testimonials %} + {% for test in testimonials %}
    @@ -182,23 +183,23 @@ layout: default

    - {{ l.index.likeWhatYouSee }} + {{ l.index.likeWhatYouSee | default: en.likeWhatYouSee }}

    - {{ l.index.firefox }} + {{ l.index.firefox | default: en.firefox }} - {{ l.index.chrome }} + {{ l.index.chrome | default: en.chrome }} - {{ l.index.online }} + {{ l.index.online | default: en.online}}
    diff --git a/fr/get_involved.md b/fr/get_involved.md new file mode 100644 index 0000000..c2ef676 --- /dev/null +++ b/fr/get_involved.md @@ -0,0 +1,83 @@ +--- +title: S'impliquer +layout: article +--- + + +# S'impliquer + +## Community + +You can chat with other Renewed Tab users using either Discord or Matrix. + +
    + + + Discord + + + + Matrix + +
    + + +## Contributing + +* [Contribute a bug fix or a new feature](https://gitlab.com/renewedtab/renewedtab/). +* [Translate Renewed Tab into your language](/translations/). +* Tell your friends about Renewed Tab. +* Review Renewed Tab on the [Firefox]({{ site.firefox }}&utm_content=review) + and [Chrome]({{ site.chrome }}&utm_content=review) stores. I appreciate seeing + reviews, and it helps inform potential new users. + +You can submit code or issues using GitLab, GitHub, email, or Discord/Matrix. + +
    + + + Help Translate + + + + GitLab + + + + GitHub (mirror) + +
    + + +## Donate + +I created Renewed Tab after being disappointed with the existing options. +They either had a bad user experience, none of the features I wanted, or +they locked _basic_ features behind a paywall. + +I decided to release Renewed Tab for free and as +open source software, +allowing anyone to see its code and create their own versions. +This, as well as the fact that I don't want to lock features behind a paywall, +means that my monetisation techniques are limited. + +I currently pay $25 per month for the Weather API, and $20 per month on hosting. + +

    + + $56 / $45 +

    + +For a one-off donation, you can subscribe and cancel after one month. + + +
    + + + Patreon + + + + Liberapay + +
    diff --git a/fr/help/faq.md b/fr/help/faq.md new file mode 100644 index 0000000..83211a9 --- /dev/null +++ b/fr/help/faq.md @@ -0,0 +1,201 @@ +--- +title: Frequently Asked Questions +layout: article +redirect_from: + - /fr/help/ +--- + + + + Back to help + + +# Frequently Asked Questions + +- [How do I enable the blur on Firefox?](#how-do-i-enable-the-blur-on-firefox) +- [How do I show the bookmarks bar only on the New Tab page?](#how-do-i-show-the-bookmarks-bar-only-on-the-new-tab-page) +- [How can I place widgets outside of the grid / at the bottom of the screen?](#how-can-i-place-widgets-outside-of-the-grid--at-the-bottom-of-the-screen) +- [Why does the extension request to read all the data for a website?](#why-does-the-extension-request-to-read-all-the-data-for-a-website) +- [Why does a background that I've blocked still appear?](#why-does-a-background-that-ive-blocked-still-appear) +- [Why isn't the background image appearing?](#why-isnt-the-background-image-appearing) +- [Why don't you support browser sync?](#why-dont-you-support-browser-sync) +- [Why don't you support X browser?](#why-dont-you-support-x-browser) +- [Why do I get an error when entering a custom URL in the web version?](#why-do-i-get-an-error-when-entering-a-custom-url-in-the-web-version) +- [How do I add custom widgets?](#how-do-i-add-custom-widgets) +- [How can I get in contact?](#how-can-i-get-in-contact) + +## How do I enable the blur on Firefox? + +Edit: Firefox has broken support for this feature for now. +Hopefully it'll be readded in the future. + + + +## How do I show the bookmarks bar only on the New Tab page? + +On Chrome, there's no way to show the **builtin** bookmarks bar only +on the New Tab page. However, Renewed Tab provides its own bookmarks bar which +you can enable by going to Settings > General > Bookmarks Bar. + +On Firefox, you can right-click next to the address bar > Bookmarks Toolbar > +Only Show on New Tab. + +![Only show on new tab](/static/images/help/firefox_bookmarks.png) + +## How can I place widgets outside of the grid / at the bottom of the screen? + +Renewed Tab requires all widgets to be placed on the grid. This is great for +the User Experience, as it's simple, but makes it harder to do certain things. + +To make a widget appear to be at the bottom of the screen, you can use the +Invisible widget to add vertical spacing between widgets. + +## Why does the extension request to read all the data for a website? + +Some widgets, such as Feed, require loading information from a URL. +Web browsers tend to have strict permission systems, such that a browser +extension needs to request permission to do certain things. +Contacting a website is one of those things. + +For example, in order to load a news feed from bbc.co.uk, the extension needs +to be granted permission to access bbc.co.uk. + +Renewed Tab doesn't read any of your personal information or history for the +websites you grant access to. It just makes a web request to the website to load +the content. + +Example messages: + +> "Renewed Tab" has requested additional permissions.\\ +> It could: +> - Read and change your data on feeds.bbci.co.uk + +> Renewed Tab requests additional permissions.\\ +> It wants to: +> - Access your data for feeds.bbci.co.uk + +## Why does a background that I've blocked still appear? + +The Renewed Tab API server only has 4 images available to choose from at a time. +If you've blocked a lot of images, then it's possible that you may end up with +all of these available images being blocked - if this is the case, then the +first image will be used. + +The reason this is done is to avoid hitting the Unsplash API too much. + +## Why isn't the background image appearing? + +Extensions like DarkReader can conflict with the background image, you can +disable it per-site. + +Alternatively, it may be a connection issue with the Renewed Tab API or unsplash, +or a configuration issue. + +## Why don't you support browser sync? + +Chrome and Firefox sync is limited to 8KB per key. It is common for components like notes +to exceed this limit, which makes it impractical to support sync. + +You can use Settings () > Import / Export to share +your setup between browsers. + +## Why don't you support X browser? + +We only support the latest 2 versions of Firefox and Chrome; it is hard to test +and provide support for every browser. + +Renewed Tab is built using cross-platform technologies, meaning that it is likely +that it will work on your browser despite not being supported. + +You can download .zips of the browser extension: + +1. Go to [GitLab pipelines](https://gitlab.com/renewedtab/renewedtab/-/pipelines). +2. Find the commit you're interested in. Typically, you want a release commit + like "Release 1.2.3". +3. Click the download button () to the right of the row. +4. Select "Download webext:archive artifact". + +If you have a problem with an unsupported browser, then we are unlikely to be +able to help. However, we may accept patches/PRs to fix issues on unsupported +platforms as long as it doesn't introduce architectural problems, and the +problem is not due to the browser incorrectly implementing web standards. + +## Why do I get an error when entering a custom URL in the web version? + +If you try to enter a custom URL that is not allowed in the web version, you +will get the following error: + +> Accessing host example.com is not allowed on the web version. For +> security reasons, the web version may only access pre-approved domains. +> Consider using the Chrome/Firefox extension instead. + +The web version uses a proxy to access URLs, rather than contacting them +directly. This is to get around +[Cross Origin Resource Sharing](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) +(CORS) restrictions: web pages can't make requests to other websites without the +other website giving permission. + +The web version's proxy restricts the domains you can use for +[security reasons](https://owasp.org/www-community/attacks/Server_Side_Request_Forgery). +If any domain were allowed, malicious users could mess with DNS records to allow +accessing internal services on the server. + +You may be able to ask for a website to be allowed by the proxy. However, you +should use the Chrome/Firefox extension instead, as it doesn't have this +restriction + +Note: If you get the error whilst using the browser extension, there's something +_wrong_. Please report it below. + +## How do I add custom widgets? + +We would really like to support custom widgets. But unfortunately, it's not +possible due to the developer terms that Firefox and Chrome enforce on extension +developers. We're not allowed to let users upload code which runs in the +extension context. + +GreaseMonkey is allowed because it runs on websites, not as an extension webpage. +We'll continue to look for alternatives for this, as we'd really like to allow it. + +What you can do is use an IFrame widget to show a webpage as if it were a widget. +You can use this to create custom widgets. + +## How can I get in contact? + +Making an issue on the Issue Tracker is the preferred way of discussing +Renewed Tab bugs and feature requests. + +If you need help, you can use any of these options. Discord or Matrix is likely +to be the quickest. + +
    + + + Issue Tracker + + + + Contact Me + + + + Discord + + + + Matrix + + + + GitHub (mirror) + +
    diff --git a/fr/index.html b/fr/index.html new file mode 100644 index 0000000..eaf46db --- /dev/null +++ b/fr/index.html @@ -0,0 +1,4 @@ +--- +title: Renewed Tab +layout: homepage +--- diff --git a/ms/get_involved.md b/ms/get_involved.md new file mode 100644 index 0000000..2c4939f --- /dev/null +++ b/ms/get_involved.md @@ -0,0 +1,83 @@ +--- +title: Libatkan Diri +layout: article +--- + + +# Libatkan Diri + +## Community + +You can chat with other Renewed Tab users using either Discord or Matrix. + +
    + + + Discord + + + + Matrix + +
    + + +## Contributing + +* [Contribute a bug fix or a new feature](https://gitlab.com/renewedtab/renewedtab/). +* [Translate Renewed Tab into your language](/translations/). +* Tell your friends about Renewed Tab. +* Review Renewed Tab on the [Firefox]({{ site.firefox }}&utm_content=review) + and [Chrome]({{ site.chrome }}&utm_content=review) stores. I appreciate seeing + reviews, and it helps inform potential new users. + +You can submit code or issues using GitLab, GitHub, email, or Discord/Matrix. + +
    + + + Help Translate + + + + GitLab + + + + GitHub (mirror) + +
    + + +## Donate + +I created Renewed Tab after being disappointed with the existing options. +They either had a bad user experience, none of the features I wanted, or +they locked _basic_ features behind a paywall. + +I decided to release Renewed Tab for free and as +open source software, +allowing anyone to see its code and create their own versions. +This, as well as the fact that I don't want to lock features behind a paywall, +means that my monetisation techniques are limited. + +I currently pay $25 per month for the Weather API, and $20 per month on hosting. + +

    + + $56 / $45 +

    + +For a one-off donation, you can subscribe and cancel after one month. + + +
    + + + Patreon + + + + Liberapay + +
    diff --git a/ms/help/faq.md b/ms/help/faq.md new file mode 100644 index 0000000..2f8f88b --- /dev/null +++ b/ms/help/faq.md @@ -0,0 +1,201 @@ +--- +title: Frequently Asked Questions +layout: article +redirect_from: + - /ms/help/ +--- + + + + Back to help + + +# Frequently Asked Questions + +- [How do I enable the blur on Firefox?](#how-do-i-enable-the-blur-on-firefox) +- [How do I show the bookmarks bar only on the New Tab page?](#how-do-i-show-the-bookmarks-bar-only-on-the-new-tab-page) +- [How can I place widgets outside of the grid / at the bottom of the screen?](#how-can-i-place-widgets-outside-of-the-grid--at-the-bottom-of-the-screen) +- [Why does the extension request to read all the data for a website?](#why-does-the-extension-request-to-read-all-the-data-for-a-website) +- [Why does a background that I've blocked still appear?](#why-does-a-background-that-ive-blocked-still-appear) +- [Why isn't the background image appearing?](#why-isnt-the-background-image-appearing) +- [Why don't you support browser sync?](#why-dont-you-support-browser-sync) +- [Why don't you support X browser?](#why-dont-you-support-x-browser) +- [Why do I get an error when entering a custom URL in the web version?](#why-do-i-get-an-error-when-entering-a-custom-url-in-the-web-version) +- [How do I add custom widgets?](#how-do-i-add-custom-widgets) +- [How can I get in contact?](#how-can-i-get-in-contact) + +## How do I enable the blur on Firefox? + +Edit: Firefox has broken support for this feature for now. +Hopefully it'll be readded in the future. + + + +## How do I show the bookmarks bar only on the New Tab page? + +On Chrome, there's no way to show the **builtin** bookmarks bar only +on the New Tab page. However, Renewed Tab provides its own bookmarks bar which +you can enable by going to Settings > General > Bookmarks Bar. + +On Firefox, you can right-click next to the address bar > Bookmarks Toolbar > +Only Show on New Tab. + +![Only show on new tab](/static/images/help/firefox_bookmarks.png) + +## How can I place widgets outside of the grid / at the bottom of the screen? + +Renewed Tab requires all widgets to be placed on the grid. This is great for +the User Experience, as it's simple, but makes it harder to do certain things. + +To make a widget appear to be at the bottom of the screen, you can use the +Invisible widget to add vertical spacing between widgets. + +## Why does the extension request to read all the data for a website? + +Some widgets, such as Feed, require loading information from a URL. +Web browsers tend to have strict permission systems, such that a browser +extension needs to request permission to do certain things. +Contacting a website is one of those things. + +For example, in order to load a news feed from bbc.co.uk, the extension needs +to be granted permission to access bbc.co.uk. + +Renewed Tab doesn't read any of your personal information or history for the +websites you grant access to. It just makes a web request to the website to load +the content. + +Example messages: + +> "Renewed Tab" has requested additional permissions.\\ +> It could: +> - Read and change your data on feeds.bbci.co.uk + +> Renewed Tab requests additional permissions.\\ +> It wants to: +> - Access your data for feeds.bbci.co.uk + +## Why does a background that I've blocked still appear? + +The Renewed Tab API server only has 4 images available to choose from at a time. +If you've blocked a lot of images, then it's possible that you may end up with +all of these available images being blocked - if this is the case, then the +first image will be used. + +The reason this is done is to avoid hitting the Unsplash API too much. + +## Why isn't the background image appearing? + +Extensions like DarkReader can conflict with the background image, you can +disable it per-site. + +Alternatively, it may be a connection issue with the Renewed Tab API or unsplash, +or a configuration issue. + +## Why don't you support browser sync? + +Chrome and Firefox sync is limited to 8KB per key. It is common for components like notes +to exceed this limit, which makes it impractical to support sync. + +You can use Settings () > Import / Export to share +your setup between browsers. + +## Why don't you support X browser? + +We only support the latest 2 versions of Firefox and Chrome; it is hard to test +and provide support for every browser. + +Renewed Tab is built using cross-platform technologies, meaning that it is likely +that it will work on your browser despite not being supported. + +You can download .zips of the browser extension: + +1. Go to [GitLab pipelines](https://gitlab.com/renewedtab/renewedtab/-/pipelines). +2. Find the commit you're interested in. Typically, you want a release commit + like "Release 1.2.3". +3. Click the download button () to the right of the row. +4. Select "Download webext:archive artifact". + +If you have a problem with an unsupported browser, then we are unlikely to be +able to help. However, we may accept patches/PRs to fix issues on unsupported +platforms as long as it doesn't introduce architectural problems, and the +problem is not due to the browser incorrectly implementing web standards. + +## Why do I get an error when entering a custom URL in the web version? + +If you try to enter a custom URL that is not allowed in the web version, you +will get the following error: + +> Accessing host example.com is not allowed on the web version. For +> security reasons, the web version may only access pre-approved domains. +> Consider using the Chrome/Firefox extension instead. + +The web version uses a proxy to access URLs, rather than contacting them +directly. This is to get around +[Cross Origin Resource Sharing](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) +(CORS) restrictions: web pages can't make requests to other websites without the +other website giving permission. + +The web version's proxy restricts the domains you can use for +[security reasons](https://owasp.org/www-community/attacks/Server_Side_Request_Forgery). +If any domain were allowed, malicious users could mess with DNS records to allow +accessing internal services on the server. + +You may be able to ask for a website to be allowed by the proxy. However, you +should use the Chrome/Firefox extension instead, as it doesn't have this +restriction + +Note: If you get the error whilst using the browser extension, there's something +_wrong_. Please report it below. + +## How do I add custom widgets? + +We would really like to support custom widgets. But unfortunately, it's not +possible due to the developer terms that Firefox and Chrome enforce on extension +developers. We're not allowed to let users upload code which runs in the +extension context. + +GreaseMonkey is allowed because it runs on websites, not as an extension webpage. +We'll continue to look for alternatives for this, as we'd really like to allow it. + +What you can do is use an IFrame widget to show a webpage as if it were a widget. +You can use this to create custom widgets. + +## How can I get in contact? + +Making an issue on the Issue Tracker is the preferred way of discussing +Renewed Tab bugs and feature requests. + +If you need help, you can use any of these options. Discord or Matrix is likely +to be the quickest. + +
    + + + Issue Tracker + + + + Contact Me + + + + Discord + + + + Matrix + + + + GitHub (mirror) + +
    diff --git a/ms/index.html b/ms/index.html new file mode 100644 index 0000000..eaf46db --- /dev/null +++ b/ms/index.html @@ -0,0 +1,4 @@ +--- +title: Renewed Tab +layout: homepage +---