From 08f9a659004f87c98f0641d0b8c720f9d7fca240 Mon Sep 17 00:00:00 2001 From: el00ruobuob <37215310+el00ruobuob@users.noreply.github.com> Date: Thu, 21 Jun 2018 17:56:08 +0200 Subject: [PATCH] library page creation + Revuo Monero published (compressed version with www.ilovepdf.com best quality) + Zero to Monero published (all credit to @UkoeHB) - version updated on 2018-06-27 + Mastering Monero (Preview) published (compressed version with www.ilovepdf.com best quality) + Readme Update --- README.md | 109 +++++++++++++++++++-------- _data/lang/en/footer-1.yml | 2 + _data/lang/en/navigation.yml | 4 +- _data/lang/es/footer-1.yml | 2 + _data/lang/es/navigation.yml | 4 +- _data/lang/fr/footer-1.yml | 2 + _data/lang/fr/navigation.yml | 2 + _data/lang/it/footer-1.yml | 2 + _data/lang/it/navigation.yml | 2 + _data/lang/pl/footer-1.yml | 2 + _data/lang/pl/navigation.yml | 2 + _data/lang/template/footer-1.yml | 2 + _data/lang/template/navigation.yml | 4 +- _i18n/en.yml | 36 +++++++++ _i18n/es.yml | 37 +++++++++ _i18n/fr.yml | 37 +++++++++ _i18n/it.yml | 37 +++++++++ _i18n/pl.yml | 39 +++++++++- library/Mastering-Monero-Preview.pdf | Bin 0 -> 1896868 bytes library/Monero-Revuo-3Q-2017.pdf | Bin 0 -> 424409 bytes library/Revuo-2017-Q4.pdf | Bin 0 -> 408872 bytes library/Zero-to-Monero-1-0-0.pdf | Bin 0 -> 670388 bytes library/index.md | 27 +++++++ 23 files changed, 317 insertions(+), 35 deletions(-) create mode 100644 library/Mastering-Monero-Preview.pdf create mode 100644 library/Monero-Revuo-3Q-2017.pdf create mode 100644 library/Revuo-2017-Q4.pdf create mode 100644 library/Zero-to-Monero-1-0-0.pdf create mode 100644 library/index.md diff --git a/README.md b/README.md index 570f790f..af42ee1c 100644 --- a/README.md +++ b/README.md @@ -31,17 +31,19 @@ The multilingual update has recently been rolled out. The website now requires m 12.0 How to add a question to the FAQ -13.0 How to translate a page +13.0 How to add a publication to the Library -14.0 How to add a new language +14.0 How to translate a page -15.0 License +15.0 How to add a new language + +16.0 License ## 1.0 Introduction This README here to walk you through everything you need to know to make changes, edits, or even completely new pages for the new [getmonero.org website](https://getmonero.org/). It'll definitely be a bit of a ride, so strap yourself in. -Feel free to skip down to a relevant section if you already know what you need. So to go to the 'How to make a User Guide' section use your find function and type '5.0'. +Feel free to skip down to a relevant section if you already know what you need. So to go to the 'How to make a User Guide' section use your find function and type '5.0'. If for any reason you have questions or need to contact us, you can find us on the IRC channel #monero. We'll do whatever we can to help you. @@ -120,7 +122,7 @@ author: YOUR NAME OR HANDLE HERE ``` ### 4.4 Write -After the front matter is finished you are free to write the remainder of your blog post in markdown. +After the front matter is finished you are free to write the remainder of your blog post in markdown. ### 4.5 Build/Test Build your website using `jekyll serve` if it's not rebuilding automatically and test that your page appears in the 'News' section of the website, as well as the sidebars. @@ -253,7 +255,7 @@ The layout will depend on if you are simply presenting an idea that you do not p ### 7.4 Editing the .yml file -Navigate to the /_data folder and open the file titled `ffs.yml`. In this file you will find a long list of FFS proposals. +Navigate to the /_data folder and open the file titled `ffs.yml`. In this file you will find a long list of FFS proposals. **DO NOT MESS WITH THE FORMATTING OR INDENTATION OF ANYTHING OR JEKYLL WILL NOT BUILD PROPERLY!** @@ -266,11 +268,11 @@ Identify the section you will be placing your proposal in. If you used `ffs-idea author: ``` -and paste it as the very top underneath the `proposals:`. +and paste it as the very top underneath the `proposals:`. **Make sure the indentation is EXACTLY the same as the other proposals in the area. If it's not the jekyll build WILL fail. If in doubt, put the line with the hyphen (-name) all the way to the left and press space four time, and then put the remainder of the variables all the way to the left and press space six times.** -Fill in the information. +Fill in the information. * `name:` should be the same as the title chosen in 7.3 * for `url:` you should append the EXACT name of the file as chosen in 7.2 to the current string but with `.html` at the end instead of `.md`. So it should look like `/forum-funding-system/proposals/YOUR-FILE-NAME.html` * `summary:` should be the same summary copy and pasted from the front matter in 7.3 @@ -294,7 +296,7 @@ You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure If you are acting on behalf of another individual, please make sure you get their permission first before adding them onto the Team page. ### 8.1 Change the .yml file -Navigate to the `/_data/` folder and open `team.yml`. You will notice a long list separated by main `-area:` tags. +Navigate to the `/_data/` folder and open `team.yml`. You will notice a long list separated by main `-area:` tags. **DO NOT MESS WITH THE FORMATTING OR INDENTATION OF ANYTHING OR JEKYLL WILL NOT BUILD PROPERLY!** @@ -320,7 +322,7 @@ You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure ## 9.0 How to make an Event ### 9.1 Edit the .yml file -Navigate to the `/_data/` folder and open `events.yml`. You will notice a list separated by hyphenated `-event` tags. +Navigate to the `/_data/` folder and open `events.yml`. You will notice a list separated by hyphenated `-event` tags. **DO NOT MESS WITH THE FORMATTING OR INDENTATION OF ANYTHING OR JEKYLL WILL NOT BUILD PROPERLY!** @@ -356,7 +358,7 @@ You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure ## 10.0 How to update the Roadmap ### 10.1 Edit the .yml file -Navigate to the `/_data/` folder and open `roadmap.yml`. You will notice a list separated by hyphenated `-year` tags. +Navigate to the `/_data/` folder and open `roadmap.yml`. You will notice a list separated by hyphenated `-year` tags. **DO NOT MESS WITH THE FORMATTING OR INDENTATION OF ANYTHING OR JEKYLL WILL NOT BUILD PROPERLY!** @@ -388,7 +390,7 @@ You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure ## 11.0 How to add a new Merchant ### 11.1 Edit the .yml file -Navigate to the `/_data/` folder and open `merchants.yml`. You will notice a list separated by hyphenated `-category` tags. +Navigate to the `/_data/` folder and open `merchants.yml`. You will notice a list separated by hyphenated `-category` tags. **DO NOT MESS WITH THE FORMATTING OR INDENTATION OF ANYTHING OR JEKYLL WILL NOT BUILD PROPERLY!** @@ -425,7 +427,7 @@ Copy the code below:
TRANSLATE THIS
`) should be fine. Testing is VERY important, so do NOT skip step 13.4. If during testing, the page appears different from the original English page (besides the translated text of course), you did something wrong and may have to start again. -### 13.4 Remove the 'untranslated' snippet +### 14.4 Remove the 'untranslated' snippet Somewhere on the page (usually the top) should be a snippet that says `{% include untranslated.html %}`. Simply delete this completely from the file. This will remove the orange bar from the bottom saying the page is untranslated. -### 13.5 Build/Test +### 14.5 Build/Test Build your website using `jekyll serve` if it's not rebuilding automatically. If the build is successful, go to the correct page in the correct language and check to see that everything is translated, and that the page looks identical to the original English page (besides the translated text). Test the page and let rehrar know if there are any bugs. -### 13.6 Submit a Pull Request +### 14.6 Submit a Pull Request You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure to make any changes if requested. -## 14.0 How to add a new language +## 15.0 How to add a new language Whoo boy, this is the big one. Please follow all directions exactly. -### 14.1 _config.yml file -Navigate to the root folder of the whole website and find the file labeled `_config.yml`. Open it and find the line that says `languages:`. Add your two letter language code (Google it if you don't know it) in between the brackets after the others already present. You will need to put a comma after the previous last one. +### 15.1 _config.yml file +Navigate to the root folder of the whole website and find the file labeled `_config.yml`. Open it and find the line that says `languages:`. Add your two letter language code (Google it if you don't know it) in between the brackets after the others already present. You will need to put a comma after the previous last one. Example: ``` @@ -495,28 +542,28 @@ languages: ["en", "es", "NEW LANG HERE"] ``` Save and exit the file. -### 14.2 _data folder -Navigate to the `_data/lang` folder and copy the `template` folder. Paste it into the same folder and the copy renamed to the two letter language code of the language you will be translated to. +### 15.2 _data folder +Navigate to the `_data/lang` folder and copy the `template` folder. Paste it into the same folder and the copy renamed to the two letter language code of the language you will be translated to. **The template folder itself should still be there. It should not be renamed. There should be a new folder in addition to the ones that were already there.** Translate the content of the files. Do not touch anything labeled `url`, and in the roadmap.yml ONLY translate the `name:` content. -### 14.3 _i18n folder +### 15.3 _i18n folder Navigate to the _i18n folder and duplicate the en.yml file. Rename the duplicate to the two letter language code of your language with a `.yml` at the end and change all sections marked 'translated: "yes"' to 'translated: "no"'. Change back to 'yes' once you have translated that section. Now duplicate the `en` folder and rename it with the correct language code. **The original folder and yml file themselves should still be there. They should not be renamed. There should be a new folder and yml file in addition to the ones that were already there.** Enter the .yml file and translate everything there. -### 14.3 Translate +### 15.3 Translate If you will be translating the content, please refer to section 13.0 in this README for instructions on translating pages. -### 14.4 Build/Test +### 15.4 Build/Test Build your website using `jekyll serve`. If the build is successful, navigate to any page on the site and check to make sure that your language is appearing in the dropdown for languages on both mobile and desktop. -### 14.5 Submit a Pull Request +### 15.5 Submit a Pull Request You're all done. Submit a PR and wait for it to be reviewed and merged. Be sure to make any changes if requested. -## 15.0 Website License +## 16.0 Website License Copyright (c) 2014-2017, The Monero Project diff --git a/_data/lang/en/footer-1.yml b/_data/lang/en/footer-1.yml index 2d0408f8..fd352b1d 100644 --- a/_data/lang/en/footer-1.yml +++ b/_data/lang/en/footer-1.yml @@ -8,6 +8,8 @@ url: resources/developer-guides/ - name: User Guides url: resources/user-guides/ + - name: Library + url: library - name: RSS Feed url: https://getmonero.org/feed.xml - title: IRC Channels diff --git a/_data/lang/en/navigation.yml b/_data/lang/en/navigation.yml index 605ddb76..6eedd257 100644 --- a/_data/lang/en/navigation.yml +++ b/_data/lang/en/navigation.yml @@ -49,4 +49,6 @@ - page: Developer Guides url: resources/developer-guides - page: Technical Specs - url: technical-specs \ No newline at end of file + url: technical-specs + - page: Library + url: library \ No newline at end of file diff --git a/_data/lang/es/footer-1.yml b/_data/lang/es/footer-1.yml index 76c5aefa..1653f061 100644 --- a/_data/lang/es/footer-1.yml +++ b/_data/lang/es/footer-1.yml @@ -8,6 +8,8 @@ url: resources/developer-guides/ - name: Guias de Usuario url: resources/user-guides/ + - name: Librería + url: library - name: RSS Feed url: https://getmonero.org/feed.xml - title: Canales IRC diff --git a/_data/lang/es/navigation.yml b/_data/lang/es/navigation.yml index 19c1ebcc..fc70e418 100644 --- a/_data/lang/es/navigation.yml +++ b/_data/lang/es/navigation.yml @@ -49,4 +49,6 @@ - page: Guías de desarrolladores url: resources/developer-guides - page: Especificaciones técnicas - url: technical-specs \ No newline at end of file + url: technical-specs + - page: Librería + url: library \ No newline at end of file diff --git a/_data/lang/fr/footer-1.yml b/_data/lang/fr/footer-1.yml index 5c8d24e0..629264ff 100644 --- a/_data/lang/fr/footer-1.yml +++ b/_data/lang/fr/footer-1.yml @@ -8,6 +8,8 @@ url: resources/developer-guides/ - name: Guides Utilisateur url: resources/user-guides/ + - name: Librairie + url: library - name: Flux RSS url: https://getmonero.org/feed.xml - title: Canaux IRC diff --git a/_data/lang/fr/navigation.yml b/_data/lang/fr/navigation.yml index fa092c64..12e1aa8a 100644 --- a/_data/lang/fr/navigation.yml +++ b/_data/lang/fr/navigation.yml @@ -50,3 +50,5 @@ url: resources/developer-guides - page: Spécifications Techniques url: technical-specs + - page: Librairie + url: library diff --git a/_data/lang/it/footer-1.yml b/_data/lang/it/footer-1.yml index 94281c1a..265d4d74 100644 --- a/_data/lang/it/footer-1.yml +++ b/_data/lang/it/footer-1.yml @@ -8,6 +8,8 @@ url: resources/developer-guides/ - name: Guide per l'utente url: resources/user-guides/ + - name: Libreria + url: library - name: RSS Feed url: https://getmonero.org/feed.xml - title: IRC Chats diff --git a/_data/lang/it/navigation.yml b/_data/lang/it/navigation.yml index aac8d6e6..1222765c 100644 --- a/_data/lang/it/navigation.yml +++ b/_data/lang/it/navigation.yml @@ -50,3 +50,5 @@ url: resources/developer-guides - page: Specifiche Tecniche url: technical-specs + - page: Libreria + url: library diff --git a/_data/lang/pl/footer-1.yml b/_data/lang/pl/footer-1.yml index 4b3973fb..f4d94f58 100644 --- a/_data/lang/pl/footer-1.yml +++ b/_data/lang/pl/footer-1.yml @@ -8,6 +8,8 @@ url: resources/developer-guides/ - name: Przewodniki dla użytkowników url: resources/user-guides/ + - name: Księgarnia + url: library - name: Kanał RSS url: https://getmonero.org/feed.xml - title: Kanały IRC diff --git a/_data/lang/pl/navigation.yml b/_data/lang/pl/navigation.yml index c376770c..a1a053c9 100644 --- a/_data/lang/pl/navigation.yml +++ b/_data/lang/pl/navigation.yml @@ -50,3 +50,5 @@ url: resources/developer-guides - page: Właściwości techniczne url: technical-specs + - page: Księgarnia + url: library diff --git a/_data/lang/template/footer-1.yml b/_data/lang/template/footer-1.yml index cd542c29..7d350cde 100644 --- a/_data/lang/template/footer-1.yml +++ b/_data/lang/template/footer-1.yml @@ -8,6 +8,8 @@ url: resources/developer-guides/ - name: User Guides url: resources/user-guides/ + - name: Library + url: library - name: RSS Feed url: https://getmonero.org/feed.xml - title: IRC Channels diff --git a/_data/lang/template/navigation.yml b/_data/lang/template/navigation.yml index 605ddb76..6eedd257 100644 --- a/_data/lang/template/navigation.yml +++ b/_data/lang/template/navigation.yml @@ -49,4 +49,6 @@ - page: Developer Guides url: resources/developer-guides - page: Technical Specs - url: technical-specs \ No newline at end of file + url: technical-specs + - page: Library + url: library \ No newline at end of file diff --git a/_i18n/en.yml b/_i18n/en.yml index 93f07bf6..e0974ab5 100644 --- a/_i18n/en.yml +++ b/_i18n/en.yml @@ -54,6 +54,7 @@ titles: ffs-ot: Open Tasks ffs-wip: Work in Progress blogbytag: Blog by Tag + library: Library index: page_title: "Monero - secure, private, untraceable" @@ -458,6 +459,41 @@ specs: amount_hidden_title: Amount obfuscation amount_hidden_mode: Ring confidential transactions +library: + translated: "yes" + description: "Below are some publications, books or magazines available for you to download." + books: + - category: Books + publications: + - name: "Zero to Monero" + file: "Zero-to-Monero-1-0-0.pdf" + abstract: > + A comprehensive conceptual (and technical) explanation of Monero.m
z=HEm|(v44oI}vSpAxJWaxbY#h*pHh!8T+b@Afo8Sb