From 02f8d3cf667efc671b4ce1f145ca05b02bbecb54 Mon Sep 17 00:00:00 2001 From: code3z Date: Tue, 25 May 2021 20:33:17 -0400 Subject: [PATCH 01/38] First Commit for "Sharing" --- forum/README.md | 20 ++++++++++++++++++++ forum/asking-questions.md | 1 + forum/sharing.md | 39 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 60 insertions(+) create mode 100644 forum/README.md create mode 100644 forum/asking-questions.md create mode 100644 forum/sharing.md diff --git a/forum/README.md b/forum/README.md new file mode 100644 index 0000000..447da90 --- /dev/null +++ b/forum/README.md @@ -0,0 +1,20 @@ +# Using the Forum + +The [modding forum]() will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. You may also want to look at these git repositories for more mods: + + +Contents +- ## Asking Questions +- ## Sharing mods + - Code headers + - Approval: + - TODOs: + - Versioning + - Approval: + - TODOs: + - Tagging + - Approval: + - TODOs: + - Forum Etiquette + - Approval: + - TODOs: diff --git a/forum/asking-questions.md b/forum/asking-questions.md new file mode 100644 index 0000000..c8ff1a6 --- /dev/null +++ b/forum/asking-questions.md @@ -0,0 +1 @@ +# Asking Questions on the Forum diff --git a/forum/sharing.md b/forum/sharing.md new file mode 100644 index 0000000..0098b0b --- /dev/null +++ b/forum/sharing.md @@ -0,0 +1,39 @@ +# Sharing your Mods + +Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. It will also help you use best practices and get help on your code. But it may also mean you have to respond to bugs in your code and help other people use your code. + + +## Code headers + +Putting a comment at the top of your code helps people understand it, use it, and remember where it came from. Consider using this template: +``` +/* ---------------------------------------------------------------- + + <Coding languages> + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Description: <description> + Filename: <filename> + Platform: <Linux/Mac/Windows/All> + Version: <version> + Date: <date> + Author: <github username> <forum username> <other contributors> + Topic: forum.vivaldi.net/topic/<topic> + ----------------------------------------------------------------- */ +``` + +## Versioning Your Mods + +TODO + +## Tagging your Mods + +Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others you want: +[Mod] +[CSS] and/or [JS] +[Area] (what area of the UI does it affect?) + +> Please don't make new tags on your own! + +## Forum etiquette + +Please refer to the Community Code of Conduct. If your post contains more than one word in ALL CAPS, you probably From b36bad4e36d3517cbcbc06a2cb8f3bc98356c5d3 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Wed, 26 May 2021 16:45:08 -0400 Subject: [PATCH 02/38] tiosgz suggestions --- forum/README.md | 6 ++++-- forum/asking-questions.md | 8 ++++++++ forum/sharing.md | 31 ++++++++++++++++--------------- 3 files changed, 28 insertions(+), 17 deletions(-) diff --git a/forum/README.md b/forum/README.md index 447da90..309cb7d 100644 --- a/forum/README.md +++ b/forum/README.md @@ -3,8 +3,10 @@ The [modding forum]() will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. You may also want to look at these git repositories for more mods: <TODO> -Contents +Contents (for drafting only, to be taken out) - ## Asking Questions + - Approval: + - TODOs: - ## Sharing mods - Code headers - Approval: @@ -16,5 +18,5 @@ Contents - Approval: - TODOs: - Forum Etiquette - - Approval: + - Approval: tiosgz says remove it - TODOs: diff --git a/forum/asking-questions.md b/forum/asking-questions.md index c8ff1a6..dcd3b04 100644 --- a/forum/asking-questions.md +++ b/forum/asking-questions.md @@ -1 +1,9 @@ # Asking Questions on the Forum +Author(s): code3z (@code3 on the forum) + +The [modding forum]() is also a great place to ask questions about modding. Before asking: + - Search the forum and the internet to make sure there is not already a good answer + +When asking a question: + - Be polite and don't use ALL CAPS + - If you are asking questions or trying to debug a certain piece of code, share that code diff --git a/forum/sharing.md b/forum/sharing.md index 0098b0b..3776cba 100644 --- a/forum/sharing.md +++ b/forum/sharing.md @@ -1,27 +1,28 @@ # Sharing your Mods +Author(s): code3z (@code3 on the forum) -Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. It will also help you use best practices and get help on your code. But it may also mean you have to respond to bugs in your code and help other people use your code. +Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help from the community. But it may also mean you have to respond to bugs in your code and help other people use your code. ## Code headers Putting a comment at the top of your code helps people understand it, use it, and remember where it came from. Consider using this template: ``` -/* ---------------------------------------------------------------- - <TITLE> - <Coding languages> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Description: <description> - Filename: <filename> - Platform: <Linux/Mac/Windows/All> - Version: <version> - Date: <date> - Author: <github username> <forum username> <other contributors> - Topic: forum.vivaldi.net/topic/<topic> - ----------------------------------------------------------------- */ +/** + * <TITLE> + * <Coding languages> + - - - - - - - - - - - - - - - - - - - - - - + * Description: <description> + * Filename: <filename> + * Platform: <Linux/Mac/Windows/All> + * Version: <version> + * Date: <date> + * Author: <github username, forum username, other contributors> + * Topic: https://forum.vivaldi.net/topic/<topic> +**/ ``` -## Versioning Your Mods +### Versioning Your Mods TODO @@ -34,6 +35,6 @@ Tagging your mods helps others find them. Use the forum tagging feature to inser > Please don't make new tags on your own! -## Forum etiquette +## Forum etiquette (may be taken out) Please refer to the Community Code of Conduct. If your post contains more than one word in ALL CAPS, you probably From c5a919cf5fe78d0a7b829475ac4bba1f5675b1a9 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Wed, 26 May 2021 16:53:00 -0400 Subject: [PATCH 03/38] More! Including rename forum -> community --- {forum => community}/README.md | 11 +++++++++-- {forum => community}/asking-questions.md | 0 {forum => community}/sharing.md | 4 ++-- 3 files changed, 11 insertions(+), 4 deletions(-) rename {forum => community}/README.md (67%) rename {forum => community}/asking-questions.md (100%) rename {forum => community}/sharing.md (81%) diff --git a/forum/README.md b/community/README.md similarity index 67% rename from forum/README.md rename to community/README.md index 309cb7d..16d1952 100644 --- a/forum/README.md +++ b/community/README.md @@ -1,13 +1,20 @@ # Using the Forum The [modding forum]() will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. You may also want to look at these git repositories for more mods: -<TODO> + - https://github.com/LonMcGregor/VivaldiMods + - https://github.com/luetage/vivaldi_modding + - (Work in progress, more to be added) + +And don't hesitate to make your own modding repository! Contents (for drafting only, to be taken out) - ## Asking Questions - Approval: - - TODOs: + - TODOs: - ## Sharing mods + - git + - Approval: + - TODOs: Add more repos and official section - Code headers - Approval: - TODOs: diff --git a/forum/asking-questions.md b/community/asking-questions.md similarity index 100% rename from forum/asking-questions.md rename to community/asking-questions.md diff --git a/forum/sharing.md b/community/sharing.md similarity index 81% rename from forum/sharing.md rename to community/sharing.md index 3776cba..bbc7462 100644 --- a/forum/sharing.md +++ b/community/sharing.md @@ -16,7 +16,7 @@ Putting a comment at the top of your code helps people understand it, use it, an * Filename: <filename> * Platform: <Linux/Mac/Windows/All> * Version: <version> - * Date: <date> + * Date: <date or last update> * Author: <github username, forum username, other contributors> * Topic: https://forum.vivaldi.net/topic/<topic> **/ @@ -24,7 +24,7 @@ Putting a comment at the top of your code helps people understand it, use it, an ### Versioning Your Mods -TODO +Instead of tracking each edit to your mod as a separate version, its easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others keep track of the mod version. ## Tagging your Mods From fc0bc3ed6e78096deb88ce24da451a425b5c6f1a Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Fri, 28 May 2021 18:01:54 -0400 Subject: [PATCH 04/38] Added Git and Fixes --- community/README.md | 2 +- community/asking-questions.md | 2 +- community/git.md | 13 +++++++++++++ community/sharing.md | 34 +++++++++++++++++++++++----------- 4 files changed, 38 insertions(+), 13 deletions(-) create mode 100644 community/git.md diff --git a/community/README.md b/community/README.md index 16d1952..a288f58 100644 --- a/community/README.md +++ b/community/README.md @@ -1,6 +1,6 @@ # Using the Forum -The [modding forum]() will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. You may also want to look at these git repositories for more mods: +The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. You may also want to look at these git repositories for more mods: - https://github.com/LonMcGregor/VivaldiMods - https://github.com/luetage/vivaldi_modding - (Work in progress, more to be added) diff --git a/community/asking-questions.md b/community/asking-questions.md index dcd3b04..1e314b5 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -1,7 +1,7 @@ # Asking Questions on the Forum Author(s): code3z (@code3 on the forum) -The [modding forum]() is also a great place to ask questions about modding. Before asking: +The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also a great place to ask questions about modding. Before asking: - Search the forum and the internet to make sure there is not already a good answer When asking a question: diff --git a/community/git.md b/community/git.md new file mode 100644 index 0000000..ac31810 --- /dev/null +++ b/community/git.md @@ -0,0 +1,13 @@ +# Sharing mods with git + +Git is a tool often used by developers to share and collaborate on great programs and docs (including this guide!). It allows developers to make individual changes to the main set of files and merge changes together. + +By using it to share your mods, you can make it easier to download a copy of all your mods, upload multiple files, put a license on all your mods, and allow others to suggest changes to make your mods better. If the Git provider has features like Issues and Projects, it can make it easier to collect bugs and plan new mods. You'll need an account on a git server provider such as Github (closed-source, free, most popular) or Gitlab (open-source, free, also popular). This guide won't teach you all about using git, but you can learn that [here]() and [here](). + +## Community Modding Git repositories + +Here are some Modding Git Repositories that members of the community created to upload their mods: + - https://github.com/LonMcGregor/VivaldiMods + - https://github.com/luetage/vivaldi_modding + - https://github.com/sjudenim/Mods-for-Vivaldi + - https://github.com/GabeVilela/Vivaldi-GX diff --git a/community/sharing.md b/community/sharing.md index bbc7462..9de6c66 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -9,16 +9,16 @@ Once you've created a mod that you're proud of, the next step is to share it. Sh Putting a comment at the top of your code helps people understand it, use it, and remember where it came from. Consider using this template: ``` /** - * <TITLE> - * <Coding languages> - - - - - - - - - - - - - - - - - - - - - - - - * Description: <description> - * Filename: <filename> - * Platform: <Linux/Mac/Windows/All> - * Version: <version> - * Date: <date or last update> - * Author: <github username, forum username, other contributors> - * Topic: https://forum.vivaldi.net/topic/<topic> + * <TITLE> + * <Coding languages> + - - - + * Description: <description> + * Filename: <filename> + * Platform: <Linux/Mac/Windows/All> + * Version: <version> + * Last update: yyyy-mm-dd + * Author(s): <github username, forum username, other contributors> + * Topic: https://forum.vivaldi.net/topic/<topic> **/ ``` @@ -26,6 +26,17 @@ Putting a comment at the top of your code helps people understand it, use it, an Instead of tracking each edit to your mod as a separate version, its easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others keep track of the mod version. +If you do want to version your mods, it would look like this: +``` +Version: 2.1 for Vivaldi 3.9.2289.3 +``` + +If you want to keep it simple and use date/vivaldi version, it would look like this (see the header template above): +``` +* Version: Vivaldi 3.9.2289.3 +* Last update: year-month-day +``` + ## Tagging your Mods Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others you want: @@ -35,6 +46,7 @@ Tagging your mods helps others find them. Use the forum tagging feature to inser > Please don't make new tags on your own! -## Forum etiquette (may be taken out) +--- +> ## Forum etiquette (to be taken out??) Please refer to the Community Code of Conduct. If your post contains more than one word in ALL CAPS, you probably From ef9d9f101492ed1449d1085c7825e5f659bb363f Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sat, 29 May 2021 19:43:37 -0400 Subject: [PATCH 05/38] Various updates --- community/README.md | 5 +---- community/asking-questions.md | 9 ++++++--- community/git.md | 10 ++++++++-- community/sharing.md | 17 ++++++++--------- 4 files changed, 23 insertions(+), 18 deletions(-) diff --git a/community/README.md b/community/README.md index a288f58..7ab674b 100644 --- a/community/README.md +++ b/community/README.md @@ -1,9 +1,6 @@ # Using the Forum -The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. You may also want to look at these git repositories for more mods: - - https://github.com/LonMcGregor/VivaldiMods - - https://github.com/luetage/vivaldi_modding - - (Work in progress, more to be added) +The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. Git and Github will also be good tools for working on and sharing your mods. And don't hesitate to make your own modding repository! diff --git a/community/asking-questions.md b/community/asking-questions.md index 1e314b5..71086ef 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -1,9 +1,12 @@ # Asking Questions on the Forum + Author(s): code3z (@code3 on the forum) -The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also a great place to ask questions about modding. Before asking: - - Search the forum and the internet to make sure there is not already a good answer +The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also a great place to ask questions about modding. Before asking, search the forum and the internet to make sure there is not already a good answer. -When asking a question: +When asking a question, keep a few simple things in mind: + - Use a topic title that is descriptive - Be polite and don't use ALL CAPS - If you are asking questions or trying to debug a certain piece of code, share that code + - Share any ways you thought + - Don't add the "mod" tag to your post - save that for when you actually publish a mod diff --git a/community/git.md b/community/git.md index ac31810..596987a 100644 --- a/community/git.md +++ b/community/git.md @@ -1,13 +1,19 @@ # Sharing mods with git +Author(s): code3z (@code3 on the forum) + Git is a tool often used by developers to share and collaborate on great programs and docs (including this guide!). It allows developers to make individual changes to the main set of files and merge changes together. -By using it to share your mods, you can make it easier to download a copy of all your mods, upload multiple files, put a license on all your mods, and allow others to suggest changes to make your mods better. If the Git provider has features like Issues and Projects, it can make it easier to collect bugs and plan new mods. You'll need an account on a git server provider such as Github (closed-source, free, most popular) or Gitlab (open-source, free, also popular). This guide won't teach you all about using git, but you can learn that [here]() and [here](). +By using it to share your mods, you can make it easier to download a copy of all your mods, upload multiple files, put a license on all your mods, and allow others to suggest changes to make your mods better. If the Git provider has features like Issues and Projects, it can make it easier to collect bugs and plan new mods. You'll need an account on a git server provider such as Github (closed-source, free, most popular) or Gitlab (open-source, free, also popular). This guide won't teach you all about using git, but you can learn that using these guides: + - + - ## Community Modding Git repositories -Here are some Modding Git Repositories that members of the community created to upload their mods: +Here are some Modding Git Repositories that members of the community created to upload their mods, you may find some useful things there: - https://github.com/LonMcGregor/VivaldiMods - https://github.com/luetage/vivaldi_modding - https://github.com/sjudenim/Mods-for-Vivaldi - https://github.com/GabeVilela/Vivaldi-GX + +If you have a modding repository of your own, you can add it with a pull request (even your repo is on Gitlab or another provider). diff --git a/community/sharing.md b/community/sharing.md index 9de6c66..2d62419 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -10,13 +10,11 @@ Putting a comment at the top of your code helps people understand it, use it, an ``` /** * <TITLE> - * <Coding languages> - - - * Description: <description> * Filename: <filename> * Platform: <Linux/Mac/Windows/All> - * Version: <version> - * Last update: yyyy-mm-dd + * Version: Vivaldi version <version> * Author(s): <github username, forum username, other contributors> * Topic: https://forum.vivaldi.net/topic/<topic> **/ @@ -26,23 +24,24 @@ Putting a comment at the top of your code helps people understand it, use it, an Instead of tracking each edit to your mod as a separate version, its easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others keep track of the mod version. +Because the forum and Git keep track of posting times, it is probably not necessary to include the last update time in the code header (but you can if you want). + If you do want to version your mods, it would look like this: ``` Version: 2.1 for Vivaldi 3.9.2289.3 ``` -If you want to keep it simple and use date/vivaldi version, it would look like this (see the header template above): +If you want to keep it simple and use the last vivaldi version, it would look like this (see the header template above): ``` * Version: Vivaldi 3.9.2289.3 -* Last update: year-month-day ``` ## Tagging your Mods -Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others you want: -[Mod] -[CSS] and/or [JS] -[Area] (what area of the UI does it affect?) +Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others that make sense: + 1. [Mod] + 2. [CSS] and/or [JS] + 3. [Area] (what area of the UI does it affect?) > Please don't make new tags on your own! From bec4fdda835e278f5a3de8d1c4858ac8afbc0ebf Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 13:08:14 -0400 Subject: [PATCH 06/38] Recommended Changes --- community/asking-questions.md | 2 +- community/sharing.md | 23 +++++++++++++---------- 2 files changed, 14 insertions(+), 11 deletions(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index 71086ef..5b4461f 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -2,7 +2,7 @@ Author(s): code3z (@code3 on the forum) -The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also a great place to ask questions about modding. Before asking, search the forum and the internet to make sure there is not already a good answer. +The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also a great place to ask questions about modding. Before asking, search the forum and the internet to check if there is not already a good answer. When asking a question, keep a few simple things in mind: - Use a topic title that is descriptive diff --git a/community/sharing.md b/community/sharing.md index 2d62419..efc700f 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -10,33 +10,33 @@ Putting a comment at the top of your code helps people understand it, use it, an ``` /** * <TITLE> + * https://forum.vivaldi.net/topic/<topic> - - - * Description: <description> * Filename: <filename> * Platform: <Linux/Mac/Windows/All> * Version: Vivaldi version <version> - * Author(s): <github username, forum username, other contributors> - * Topic: https://forum.vivaldi.net/topic/<topic> + * Author(s): <Here you can add your forum username, and your username for github or any relevant app (also add any other contributors here)> **/ ``` ### Versioning Your Mods -Instead of tracking each edit to your mod as a separate version, its easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others keep track of the mod version. +Instead of tracking each edit to your mod as a separate version, its easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others know how up-to-date the mod is. -Because the forum and Git keep track of posting times, it is probably not necessary to include the last update time in the code header (but you can if you want). +Because the forum and Git keep track of posting times, it's not necessary to include the last update time in the code header (but you can if you want). If you do want to version your mods, it would look like this: ``` -Version: 2.1 for Vivaldi 3.9.2289.3 + * Version: 2.1 for Vivaldi 3.9.2289.3 ``` If you want to keep it simple and use the last vivaldi version, it would look like this (see the header template above): ``` -* Version: Vivaldi 3.9.2289.3 + * Version: Vivaldi version 3.9.2289.3 ``` -## Tagging your Mods +## Tagging Forum Posts Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others that make sense: 1. [Mod] @@ -45,7 +45,10 @@ Tagging your mods helps others find them. Use the forum tagging feature to inser > Please don't make new tags on your own! ---- +## Describing your mods -> ## Forum etiquette (to be taken out??) -Please refer to the Community Code of Conduct. If your post contains more than one word in ALL CAPS, you probably +Now that you've added your code, titled your post, and tagged it, you need to write content! What you write is really up to you, but be sure to include what the mod does, how it will help people, and if it has any shortcomings or bugs or does not work with certain settings. + +You should also include a screenshot. If the mod does something that can only be shown through a screen recording, take a screen recording and upload it as a GIF. You can find some screen recording tools in the resources section of this guide. + +## Editing Posts From 37d42ab0f8311e4e3863d6a7c45a732787439eb8 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 13:19:44 -0400 Subject: [PATCH 07/38] More Recommended Changes --- community/asking-questions.md | 8 ++++++-- community/git.md | 10 ---------- 2 files changed, 6 insertions(+), 12 deletions(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index 5b4461f..9ae38c1 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -7,6 +7,10 @@ The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also When asking a question, keep a few simple things in mind: - Use a topic title that is descriptive - Be polite and don't use ALL CAPS - - If you are asking questions or trying to debug a certain piece of code, share that code - - Share any ways you thought + - If you are asking questions about a certain piece of code, share that code + - Share any ways you thought you might fix the problem or things that didn't work - Don't add the "mod" tag to your post - save that for when you actually publish a mod + +## Asking For mods + +You can use the forum to ask someone to make a mod for you. But remember that it is a big favor: if they wanted this mod themselves, they would have almost certainly made it. So be patient and realize that you may not get an answer at all, especially if what you're asking is hard to do. If you think that what you're asking should be implemented in Vivaldi directly, make sure you have made a feature request for it in the correct section of the forum. diff --git a/community/git.md b/community/git.md index 596987a..5f66426 100644 --- a/community/git.md +++ b/community/git.md @@ -7,13 +7,3 @@ Git is a tool often used by developers to share and collaborate on great program By using it to share your mods, you can make it easier to download a copy of all your mods, upload multiple files, put a license on all your mods, and allow others to suggest changes to make your mods better. If the Git provider has features like Issues and Projects, it can make it easier to collect bugs and plan new mods. You'll need an account on a git server provider such as Github (closed-source, free, most popular) or Gitlab (open-source, free, also popular). This guide won't teach you all about using git, but you can learn that using these guides: - - - -## Community Modding Git repositories - -Here are some Modding Git Repositories that members of the community created to upload their mods, you may find some useful things there: - - https://github.com/LonMcGregor/VivaldiMods - - https://github.com/luetage/vivaldi_modding - - https://github.com/sjudenim/Mods-for-Vivaldi - - https://github.com/GabeVilela/Vivaldi-GX - -If you have a modding repository of your own, you can add it with a pull request (even your repo is on Gitlab or another provider). From f887b11201e34aa14d2294a893cd947a15ac5dc1 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 13:43:40 -0400 Subject: [PATCH 08/38] Git --- community/git.md | 9 --------- community/sharing.md | 4 ++++ managing-mods/git.md | 23 +++++++++++++++++++++++ 3 files changed, 27 insertions(+), 9 deletions(-) delete mode 100644 community/git.md create mode 100644 managing-mods/git.md diff --git a/community/git.md b/community/git.md deleted file mode 100644 index 5f66426..0000000 --- a/community/git.md +++ /dev/null @@ -1,9 +0,0 @@ -# Sharing mods with git - -Author(s): code3z (@code3 on the forum) - -Git is a tool often used by developers to share and collaborate on great programs and docs (including this guide!). It allows developers to make individual changes to the main set of files and merge changes together. - -By using it to share your mods, you can make it easier to download a copy of all your mods, upload multiple files, put a license on all your mods, and allow others to suggest changes to make your mods better. If the Git provider has features like Issues and Projects, it can make it easier to collect bugs and plan new mods. You'll need an account on a git server provider such as Github (closed-source, free, most popular) or Gitlab (open-source, free, also popular). This guide won't teach you all about using git, but you can learn that using these guides: - - - - diff --git a/community/sharing.md b/community/sharing.md index efc700f..722d461 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -3,6 +3,9 @@ Author(s): code3z (@code3 on the forum) Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help from the community. But it may also mean you have to respond to bugs in your code and help other people use your code. +## Managing Mods + +To share mods you need to be able to manage them well. The developer tool called Git can help a lot with this, and will also help others contribute and make your mods better. There are also some other recommended methods and formats that can help you organize your mods, please see the "Managing Mods" section of this guide. ## Code headers @@ -13,6 +16,7 @@ Putting a comment at the top of your code helps people understand it, use it, an * https://forum.vivaldi.net/topic/<topic> - - - * Description: <description> + <If your description is long, put the second part here> * Filename: <filename> * Platform: <Linux/Mac/Windows/All> * Version: Vivaldi version <version> diff --git a/managing-mods/git.md b/managing-mods/git.md new file mode 100644 index 0000000..20fd9f9 --- /dev/null +++ b/managing-mods/git.md @@ -0,0 +1,23 @@ +# Managing and Sharing Mods with Git + +Author(s): code3z (@code3 on the forum) + +Git (pronounced like get) is a tool often used by developers to share and collaborate on great programs and docs (including this guide!). It allows developers to make individual changes to the main set of files and merge changes together. + +To get started, you will need an account on a git hosting platform. GitHub and GitLab are two popular options (you may want an account on both, so you can talk to people who use either one). + +When you set up your git repository, give it a name like vivaldi-mods, and choose a LICENSE and README. + +If you've never used git before, see the resources page for some helpful information. + +Like a normal file storage service, the git repository allows you to upload a folder containing your mods either using a desktop client or a web client, and to get a raw link where people can download a mod file, as well as the ability for people to download a ZIP file. + +Like a normal file storage service, the git repository can help you sync mods between different devices. + +Unlike a normal file storage service, someone can fork your repository, add their own changes, and request their changes to be merged in, thus making your mod better. + +All of these things make git a better way to store mods than copy-and-pasting them onto the forum post. Having everyone store their mods in a git repository would also make it easier to make a community collection of mods and/or a better way to install mods in the future. + +## If using Git, should I also post mods to the forum? + +You should definitely create a forum topic for each mod you make (see community/sharing). But instead of copy-and-pasting the latest version of your mod into the forum post, you can just add a link to the correct file in the git repository. From 0923c87a52a1e9669b5946908a2f7e64aa04fe53 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 13:44:11 -0400 Subject: [PATCH 09/38] Small fix --- community/asking-questions.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index 9ae38c1..8f5b377 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -13,4 +13,6 @@ When asking a question, keep a few simple things in mind: ## Asking For mods -You can use the forum to ask someone to make a mod for you. But remember that it is a big favor: if they wanted this mod themselves, they would have almost certainly made it. So be patient and realize that you may not get an answer at all, especially if what you're asking is hard to do. If you think that what you're asking should be implemented in Vivaldi directly, make sure you have made a feature request for it in the correct section of the forum. +You can use the forum to ask someone to make a mod for you. But remember that it is a big favor: if they wanted this mod themselves, they would have almost certainly made it. So be patient and realize that you may not get an answer at all, especially if what you're asking is hard to do. + +If you think that what you're asking should be implemented in Vivaldi directly, make sure you have made a feature request for it in the correct section of the forum. From 48fe6bd5bd39793f9cd9fd880bd23c24c9718c77 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 13:59:04 -0400 Subject: [PATCH 10/38] Screenshots --- assets/images/editing-mods.png | Bin 0 -> 13856 bytes assets/images/tagging-mods.png | Bin 0 -> 22170 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 assets/images/editing-mods.png create mode 100644 assets/images/tagging-mods.png diff --git a/assets/images/editing-mods.png b/assets/images/editing-mods.png new file mode 100644 index 0000000000000000000000000000000000000000..ee82216ba95770fdfbe4aa0d71b87731f8d78fd4 GIT binary patch literal 13856 zcmch;WpEtNldjuhi)Ar0S+ba!nVFecvX~{yk}PIsW@aXfnVFd^X1e<Q_wMewad-E_ zi8yCsVy3#Hqo<}jt1|P+w?gD)#o%GEVE_Ptmk<|L1OSlFCW!18(9f>}L1mhMjvN)m z1cAy4++zSB1SEt7l-<(L*WI;e4+x+x?Q)QjY_KfLh(%&@$9_@<i=knTpmJaFmla#1 zT<IVEu@YJi$^{GjwnMJV*B(?0e;6`EM2xntTB<Tqit69+Wrk`-zh{#moA`$k|Im%k zTVxEmTqesTg?lWyocI~Uv>%~x!OSumfAqvJP(P&4feM;a0$*}s>Khuk+7Q0XSWJBd zh?r4<UsLh`lAsU>{}*_O|I-~Lt}YOqf+i;WgD9Kr?z2}c0xQ3TiM_cMR8$(~A&`lI zsm6;hPx13@u2#Hr5Q1MSUZ4PH=hh}RyN!Ai6xSOddqEDVVq<EZ11P>jkvwH}bwvPv zGMB7E0_X40#b`JkpDlsZJkNg}mldRSezpWsq5t*A{O(0qH5x5i8cfa9z%0bs+A+k3 zDFBbivZT5O-t_yuokqUc(S#OsVfT%8cclv+$Gejt5c%3Q$1WQ#D8SpMQ%f=mnlr87 z=nR`k@)zio<cUXI(YQY1d7eK;;b3}LvtGWrxgk8G_g=XOYu2egi~}v(tCwJ9`|L?% zd+-E^X2D^x1uP9(2ozY;$EzBv_sGv-rvymy&H~#L_7Z}R@Xes^DPxt!*<_FmHTQgU zRKEpz0$z_J$G;KMHMynSd_>nV1LldcZz!8(9`Kg&o!-o-fo#1Gc<oAa771dOLOR(C z@)sfs;!?V*9}0K5w}GOY8+#rUom#?~`1sSaKCiC?h5BS4<RZdkokzbsNC*VP{1&3S z;$u9Os!#ZoJ*@6%lajujWIWn_b+#E9y}ji7*$9!b6+76Xj(Ggbl7v7A#2nt;<+;nd zoFdIUP9T8Sr&hq-!&LWkM8`~~(}rR$dMxts9noEojL$oK@WrrmRCG+V!4D}cyKQ%o zm$mfN2iD=urSBmZotv+x+f8QU8tv|os$`z2_&)EO6Xm?u2ohRaZFQ&F#snWoswygh z_@Nh-s4)G5I89G{zj8<z{>_GS0K#8E|8CSY&2S#)D-HK$VjZ2Y*P{cA?|*+zrXi}# zD{5$P*ln~UlrqfJ1j#<0n+)fD{JpSohNgMJ%XSH~wj*eIG_AzrL6XL`#P(iM2R#8L z`p?V$Ggtoecl>_ntD7wX7HFt`tRzghV7pJR`CAZUtOb5!YhE&L253SWcY>*45ZMv* zp&7vspyWXexNmacbhh+h$pv<b?@+&pBH_ovYkWfwvz&53y7i%=XmHUztV`CjfqIaX z?PfYE%gSyuIyFeZIH)hNAr6}ZX3K)t=x%dnTF()|PQP<bi8u45N*t*6x1Lx;7%29g zx0MGp!^Z64*tc!slg#SfXRDV8?hA)eYwJ-ALg1M#0U#Re9l;M2@H0Kco7jg9e9f<J zFpWQ1roS=i?AesXuA$;)itn4Mzmt(!F$xx(qW!#JLF--JwIbTVSr2C4#;T|KFAB5H z8{5iqk^L!LZ!nIN7%OY(!S6h@1(v>3BaS|<jLy&~3H|OVQL9Mn>ebPzpC;1cT0y|( zimA~to4C(|OuDhdGX2cZ=sK{<<hN$ehONJgM^0&o_>N5xI}ENSw40f&x-s4QaGaot z7!kTSg4f^DxscW9>RxyM#=dA)uJn8F4P29tN;RHbaJ=)zX_v%r#jl0eH|u%XM<1~O zO=JCeIXQjhdO?rCA_leSHZK>1np3U~4`j~i``LG=IZL_N!_5$>Z^h<SEDO3V8{rpC zT!=IyopGRzT#-618s+If818YY{U=H3yrkSN4Ph1<7Z3rr-h@8{9cr}tg_%hD<oDL= zt!AywxP!xUK4A1`(2;o#%c}yO5c)$q>jGs#{O18&8u0k9oEK?IPv`X`uFCK_?HD6M zsx<qF08s2zIM!Q&0AhBXSpH>u#ZyVHzWUC{`Xb!x!qu1D4a-5WgB1(Xt}FT}qy5&x zQWv^X*DU5GiDU+MQK!x3h+*Lk`Go45-U~SYc(27o^(&L!IBffa&q}h5@44#_M&3Is z)wc4R4v^h(s>(O*^=FXmla}ky#L-dXX4*sXeC|{AQBA(gGZxvw)7|4*bG{<;E>4t| z)q&&1?}_NlzRL2a)ZxrII-pal6U(~P`%O#_mU89Ijwi1q!DO&DQO5lZ7ehlG-_)0P zRb8d9m0Tv~AGJME!<`cE*`XI4QtdPxcwV!9a?TP2XUT$7Q+RrCmDiy+fPi_#bD#cJ zg3mv-3I>X?(%_U%$2Wc)j|B2{nms@Qej7^OAFXcZc8IX$hnF!~Wh@GUtI5d-v|Bgw zK=grmmLs4dKYKC@l|4B&-o~PMO+9}%D2=CBw`+HZA#_`tVsKBojp^|QKJ)$jRVX<% zvY#0*>|RHVrgTNm)(Hn`-@B&1Pc_8J=KQN)Xi^p6!S-14s?z2xcUw4to5$p~SA~IB zR;t_Op`xN9qIjyH!eIx3jR{+##|55EJTW>@o(b!N$Nw1oGRId6HK6#i!`0Q27le@a z;DtZ?%~_!Jm#rtAeE;1p#c}hw(skTWUWN|F-t4>$7$6_(bI^1<Q3-w>ayr1)M<hP` z-}qN^vV%nmrbj`8M)~CNC`70HZ%s~&v%8^}y-m{liJ@L_5ZQtCSYuzmFNhB|P{TE^ znoc;Sb2x5qw9~0p)|=FbRwsjD<8~ar4cWH{zMmKOY2mIgMiY;ZjK5g17TiG)vb0_y z8l3;+SbX^7q2-anPug#wVsC#phdj0JGh+h$e!os>Io1xC-1%H-7H)*3=%0ry@U_5t z;fw1MgF`e`;7^V?Xcv$?%I~5`Nam-$W}AQqC)st8OTedEF!c|Z#*V*y=y;1>UWT6{ z!Z-Q&rN(TJ80Tsk;Bem`Xt*~=3<5y?_!@$+i7{-T#uWwI%EGzK{9Al4M{m@%zCj+_ zpc&qQ{O9V_c4h1pB%hq|6>Y~fC=!;&A9RY!xK&Gi24Abu?hJwrY+`t|2Z82%k~<`9 zI47+R3t%495mU9)bIH;-Zv76bg}TMl;ezu1sPsk4mYM8#aM8;$W?Rs(-!ZnAekJ$Z z^4!o$Tv;2f8wpNC?vfWJV3QpR0*FG&2ckD|1S+dSCX+)zvfFn?XRhM?N!Y5rjSg7! zw_)4%wutbB0gM;YpALS`t_od@UiLP33@SC0ljlt5r&XEgsSI{ew_P>3Zey6ll{m?C zj~eqEP0<&wws<u)Wo<2%T$owCDgp8Zcc;NAHsT|jmoAba$(5Q+*S1Y+3c70p$eKug zkzP_RS_>O2y74?qnKpzI&m!Pth8kp(lLnGgeVSRZo4P>7!|VzbSuJw<%c*)1N-X5T z(Zsuqc7;5pvWga8BmN0!Ln!DWnQ-C$eu3!VrKE63lA_4?=B^=XVS<$X5a&7<5mA#p zWq5dV-{Z(=giIfQ+;O!@RFikb>=q<%zXNXlaVshuYWwdpP$M?G32~U{Z{-jho(nmS ze(3xl<_zuy+BzuBFW$ZQFcarrLgVa(8UwHAzNwoi^<An)A!KB@_hbom9Jd&o6!U{* zBL!CKITpsEqz_@3{<334>MxvMNn*P!q2we+cZBY8{3QgoQB|2a&D^Av(tE~5ku(hs ztziz{azJ8XW##IE7k{=(EB`quwIXAk<*hs9o*a`?31n5`3n5!*ImVP0G^0&Rn_z{B zV^Uk#VSt&21_q!Q_Sb*LxBua@Q$&@n>u@s)?)$S=n#2J=VZlFo5+Qz~c?n5LqsA3o z)VMm3BCV`WSf~P;i2p_8>kgH7#E7{<z%Aov!GzfwZ~N*80>eMpjVt(w<=-f2ClOz; z-K&1l$Ok@_e(p)cax;--Hn}+@&3SyT?`HssuwfvP!Zwlhb|Y(g0<pOaXEOH?7XUiN ze9(k(y@_l}rgM2%&77utGV5292q{(o6DUaZF)%!?3jcb<u|}d#&1Bk-nOCzbnxbVV zZfeVghURRFbF%<>s*pDj!Gc{!9MnR#WaKuu&>@r!FvGsnn}_Cfc6P>$v*jpiZD#1X z#t6WQmBTKLj64qy3{A~FA<vW9$JuyKn=Hu`3jc+bNCE-2kpI4u!TKP;t~Tlq`&0^p z0EAMA%NQ~#){F3npp?LP&@MYI3R$qIG3cyc2ndj3(6;~2RHfXbcso8dm!IwF5p6wd zN&bTY6Nse{tTvC=9nI)-6Ih<#7nVYA=on8=<)-F_te2dX;jm31wptaC$N1|>&}T*> zD)p*@StGq0R>CWXK8=9jq-P=MWCQhMXBf6ba660kZ6iUd?k-|~5Q=kdW0<LYX)OJB zbQ!TWk<`n%Z%FEygz4RFFJ&qwZQO!Sv?3}NGO~u}6sI;-AH%pU`vE!(f0#bAR1$~j z%pa{1cEC~P(%&8FfOTQWt<V>ri_o|Z3zFaA5`Nh_y~Vq*W_pPwsiZ6b487ehZs|)C z2^9K>ucI^HX9g#4LZAPFo{STrMX-8Nwgq<Y&dU@Lj_c(nddfPP2cmC^6X2~;qT49? zypUNk=G<8}UOJj{8yD=&v@pj}Ufik<<9Ra;))?ij&8Ac0yo$0ACF{SFn+kQ0h8&_? zw!zf}KCF>EUq2vAI#h0<Cto`QZu4@_EAn~gf5JcferDt2Q%iQ3Smi$4>XbqztUDMp zg^u(LB$c{k>}kOxTJyhm9MF%a!z(hVdGTo>rtBkY`uRE`Nipu(rncbng}pWMx#{J4 z)19SlRkCM)R$Bp!Hng*sCWb6?eRRCf1d(LtF`G*m15Dd~#QT8F$03j%bwIa;q~MgX z)O9OX%iyak86z$fKzKR<4eb(h;jDv0{%CIx<E#Ql#rOCiUv-g4$xTFB@8r^*7$mw{ zP~8MRmKgL)`yxngHSgbSazq{vj|b1&u}J>9HI569vb5f3rI}q$n@KE1oV0)m(odC- zQ#GE#ZB-eZ7}}i4+!z2-@yw9n`><P)l{KuG%OnALC;&^gZvEQq^*ld+^$KLx;*K^H zi`{;#IGOYQN?-k2(hpISo3^S6o*FzSQ@2F5r>M~<9R$Ynv_!v5xvC-O=U?`vPm37c z3S9fp`6@p?o>Cf{iyY4Dr+ed19w3kq8kSuz9&Yt8>%DrG42M1RhovaC$;*^8cn9|W zEPZ24Ysw-$1BxB#;Ca8<!N`W2PU6I-qj@j1D8TdAee2f6Y51347$ISP6Z*;zHbczV z4fQ=ZePj;06PYEu0Uv9+o=&={=l6U8gGC;kp8d|VTq6pACL~j}4o6(b4a85i_R){a z<WW|KAR|8p+{We<jC9!Do!Vx{8hV>`S8Hr6%Di>f$pXiZ&~jVuYi|Fo#H_>jT!~e0 zj@EH?ERBvVbVx!dXYAR~J}jZWla8V`Qn_fyek&u&?<>1jA3gZm@kk_?+^aTJU?fUo z+Fhyg0}&mo_H3fahr4I^gD_tnT=k<thTxz+E`eEgSF^0YE6*Su1lcLo+xQAC_yAyn z+*2{dvf675v~RBSlys)O@4Xl{Kid95wDqxI2YmK}(dsj}e%h613x*J0E&Z6BC3fR; zqn&tJUmrYccg@y1xi4HOMGE}8VpU^hHfJOKd^yrG$6Ui2vC)m*XZO@{!S><k2_zkQ z&|aL+y%1$`!GZaN9zua+4#KbR5vVO3VM{gpj3y=#!1I31#(~65^8Y%D0af69>WY*N zWf&c0Ub}{X>*6oJ$U@XU0Coe-4`wtU2+B`+6haSf!SlZfIDTLAk7Wx4aJIpSx4B*K zNob){NCKI>-Yd&0{JbLnwa58)#PT05=)dWx5W=r{OfoU@Y?4|AE38~PV#c&dK@f;P z1X&T58MIzWXUICWh#Ad-j<eJ5d@L4zqMkO^tRsAj+!E=?Doy+DSm*WQbtqy+G*q9n zLeH{9_iYl5?$7etQW%4r?zbY)bu<|MxS@ce?{)9rISe;1<ftfxDljHBnHz4KFbk?g zN26^Z<*+S%uhWxnCQTw5d_I$u@0||ZkA^;I(VizM9Iaz1MDOR;iP~6bN0rJf%*>o^ z2<Lyt)7Yq}D*h^(BV_0=z8EY;`0mSVylX4x=89E$#O5)sB~B~NPuULFmo)Y@ND=V8 z$|3L<YOT=e^7i%kq?gFf&%Qj-l`;?dzO2LT3Y<YG-TwLZAXPtp=#comrmkUb){Xr2 zVfi#wC0gwJ66>gN*&=`3^qbVh!9BLcO46EHuM-7@6|A>gY6?XeG0wP#ZADB<=8NX2 zTj)(`OWoOEGS;ov{gH!2|4ZsU7Q=%4)t1YB7*%m;^nn^2Hk%>|7g<|*Q%u9Gnj@ZB zB#z0H(&xzv5P*i+D{>^0*$9TUP-`w>oBidhCR+1{9)<^zrHab@APz<ck!XnS>&un| z!M&kXVq`0fA91kf{Z3vI0C*qm&7tr?y`w9=KN&OO0ohS0R&x7za4Vg6x863V7S<If zpdQpeCf;#x&Cuaewr@o)#-=L#UnV4iIb=*bR_`ePX1zUGTS{1*#CV%A?EzDc(TVKD z#*2+zb)Iz<qGerGaPG+&ahZ=!Q<GXzI&@~^jdqvHIYkpgF_7}F%9;f>taj7Yu~LIx zO+nfd1l*%0;jH|8X(bET7GjNm;l7L?GdY)X6xc$10dw|GRrPoo3Q3Bqp!oifeE0nA zVj#lY_MI9496ZLl3Sj(#Tl(W(d_{v^cV2ui<fy3>fZuhFx{(VDivGj^(t4YgdL@8q zX_?#XN-9$hY;CqsXpPN*=*qs8c@1~PrPEdYT=RuRWsTPbE;#u<<C#2+4!J6dr{f}_ zA0CvYyy~(IQFpaj6(9hWE;q^shcAOrCC{=`H_BgvS49Xv!t47ug2CGQi%VT<W#;<l zTLrp_j;|+Knj+=4ayFkXF~@D7?V0U@N@G-ik8}`%wnL7f+#BKYdENRtb3jR3bk;K_ z2dW@Rav?Y{+Vk#YeQ|G9Cee<<_<_7{(9ZS4zF*~Xn^o}@$DMTA_M~1#iA8tMSX6B7 z@e;2vp`R@hN@uJp14aj4T31nZRzWd-WTa-JBWG{msf(q&qEmwhBh;NijU<lmDM_Fa z1J$pv_^9SEiZ+7VRSz<BCcQq40W!@7?)lH0BX6lG_qc_V#beJ+)Tn^jK&XhbT%~R& z6^0%nZz`d!kj;>0);D}ne3>@!1;cTTJ?6vZzq=3A*gCn=L1l;wq+rSbpb?hqe>j>$ zffu*N?t4UaJ7++r&0%Hup0o7II#&uSbO^|lcw8wO)i>~H6=7fvVLQ!EzoC&$o}4pA zv(U3J7Dvx}9*1M{XqWv}D;w(is7~siiveTi7ZEZm&ttg>_(h3Y<$0T1%vK{n*=O23 znU<Z00Mk;B3-x0br<yd3f)&%sEMEfhj_BS9O3IC!A%($xTg@@ZA|@yIm8`OuHs2lX z$o4ZMlpu4R#3fptOmA=rO2m#2c`7mMB^WmNGsx5_+4a?md3<=ZT=Lb<^zZC7eyXLs z@~Puf-|wzxP8pr&UDSrf0>Qrxp8E|+v<D{fv^r-s>^uBMN$OHF6MAQ-&1-#{V7mL8 zU0%;Vvu5RFuDyMp<Bm=@nvgRTu9LwV-#{o^>~#l^M^(5?OFC%BTO1<NJ_I0Sk&DHC z>BdJm*&K;1f0^<4|8l%f2u@W`ZrV-$SDb2Sg-xd}1;P-;wFtv3SbA_pvrZNJ+*|1O z@p5fKlV_&CcnbjdwVWH&y`159cd_iR0``98TPp;w6Z~F2AEi3DXcCgaJO+#{lpKve zYFxGn@D$L%kKL#+S$Rm?lDqmqhtPSk`XML|yqizos-=X|n%|e4JBypuwY#HuI(>d9 z;ZXvq<ImB>P6h%F{`7Ar7gpr=?k^x3cF&DW60biEKRb6Vhp1qw{I*-m`XS8Hp+Ie> zQ$QVJlPoHJ4h5YWg~7^lDV2Sk?Rt?vELRZ7SXy!%9L9t8*fCk2M8YT6y-Dw^2S;5{ zh~a5+72fF~&a9UJK8{7RbAer(VEr9nVMVg*_z`UEbsKCiQJxWfbhfTq_Z1f`$w$s- zQ`n|P1x6@d6Cc|qWL<kN=ZsP74D`c?X9TA*^Z*d&oD;kT@A$D)Z{1(G1$PpTXBLod z-s0;fozZw43!b0ECX>;4M&G5X5qg#;vAkpsD+LDtbv1Q!;C&%+@WTM`M)Upla!=US zd7WX^u8YOZsn<2_VfcIK-ARVcYh<)-I2_^lxb!!IU@*T&fe{{sz8k}VMD)2e`%Rl* zyB#2jaqq;_Yzm$Mi5V3u^~QA+9yW49ch9>H4xkm`8>l33eMon9(qLB)XX<h5+-Q?E zp#~~>L9bm#bNUEhO+%HdltG%6o#<HFWLq9~;>ao!Q6dOAQR-@Ie&PE68M3Xl)xS47 z`Ncr)mS|@P-K`G*8{25Ko^I@bwy%+scN$|SWxl87u*uX&`5s)!1}@!)^9?z+0z;2N zlSN$z9h+D8RDCUW;J$9x<KG3U<GU_f$>Ky58iwe?{Ea@1%6F~>X@WAb3TbF<PUr2) zH25S4z>i{Gns&Ahw+Je^U>*GXlYDoBAxfJBbNBZ#nK^t1qm3YpNzYf-c*c})c|>+1 znz>kj@<&vqdiAkaNrBcBUx=X33E#VvOmW1RT%jV102O+d-9mz52x{?)GSJ-Q+4B=` zv3uZVYTxNSAfJg(hRyoARZc@t5C$`{E*pDQ=FE}q`J_KtxFjS3Z+vPdKZ=r}GbTW- zt(RT~PN(i9SMyOw-C<-p0(KA!e!58mGg{Vl!+XKZvM)`SHX#wDf$r`Nx6}z6Er0&S zIB@Uay`gUK1d-w0us=t;Ph~L5*KT_5gp48NVNOgY-HcBmDhr9E$8LZ;AaLDDE6kvu z4TTAZ&!-+N{P@V1NQe^E6gE&>j}=A$W9}!Qf1s<TRP`d)57=9%-uhoek%Eo?Dp=eC zbrTeXtTbcl+p`(%CYQ|;kK5=-2{&?izdBayYU&0qe|jd}dt~kS=Q!jIq5!~9hdWc! z{XTY)LDY`X4>ZDvC<$^o?T$J1%-H0a?enb0ZZ`cIEO;>at>)Z5HN<40FMK3Zjqoj2 zp3pkFGC)3ZO}sU`QQ!?XPG68|{}c2BYG1l5-h(FRy6s8(U0b4-psl2(ZC{|2?3)K^ zS`GK!uc({vZO3{q>FXD3S-#9$cF<eH&|dIiDgpwh2g@><f7_=Am%nr+r4mE<N!H|J zn(wA3amh42K2lNhZJUC~L?wDMJ>vuXR}DvS&OAZSJb%Z@eW&DE!}|>l0eiN8W&I6^ zP19fW6FViI2!<{xoJL=S=eWNH>A@pJGHh&}T*%!tW9mIzOGVVCttOU7f9xH%?@oEZ z<wwQIc^`Jrbk>YVQg}>iYPP<3s(oxOc8{)k)@;D~a7X_H^Shl1g0RwiE_Z-UEsEGC zTZRr+b%WaYq?~J94IguRIyc_;^q^+Ck}-4N7&x{Y_tI+E@~kr1ll}~l?pog^pE@6$ zBF*dR))e=Q>O21%XSA{m-Ay=GrpbqxLNTc5v4@XZF^@FB{N!<4><Eu|1gB&<5&1}U zw-J1OaCoPv*FDmxbt)iST`Apj1Nj_k_cph19bsVl<^7#pT^R$p1~chP0a`plu_gfX zY6Qqe*b<yf$<}iZ0c%kHFnw_J7;wHMOyxO4PnC&s+O*N(;c#GWw;AC$2BrUKWP3!H z=`)QC05*-Qv=<3_^d$*~y2e9@tAg$($wK0VcFU<Xr@PfxX>x&M=pVInclG=sddg7z za=)A*YdJ+w`bwh!W4PHr{NxrQ1aNhm?#3*4*P#s0qDrqK))!gYn8w}Z?TB_Pvg@q< zL+0h4xZXNbrmT?Ci(6oh`#BSZq6?YY>&`tmR<bSMgo;bFiZCNmk8h&)J3R5i;F9+b z`raF3v!4n@3vc8`F(C0Aa1a1ES^Y~+&Ge#%nCT?ll0G(q4O=O9wTQ2_VhG>kKMqbd z<~4m+bAbAw$1H;M1Fk3GQ2>|;NE~zhv5~Rl#P`L>)2y8bYzW4s8<@GL$-2Ogr3KSQ z`Z^u}0;i)A&a)~&y}h+z{xwpnx$FJxrU{@d=eQY%C~6AcNZJl`@Qf<5)Q~ZZ0Rc#% zKVW4Nx5(P7*A2MARxKbgJ#$FjRHqQl+!?h8xEkN|5v(TQ(2rIe%kvFZ-*#XexalS? z7DrE9(k13yA1%4SadpJrR=uAt+9Ua5E}YDje=l^yx~~bsrBOg-^OyYgEW1M4at(9v zK5_ET?^fS_$-|Sv0Ba$~qecM(ItUtWL-GsxxoNCjvGp4x-{|Y$C7y6LXw``e7dg%_ z&?L}MLs>-^3lq^pHx|Uw)%<25r>cFNV8n&xHdINg#B(jgXM?!^MH?c+etYmnMgkcj zEyRRdu)_joX$nSz%V)(BG0ozoBA%XaVPo`lW=sqr<=}_5I0bn{N;g>wIF)n5Ykoe; zwbH6T!^jjXe8QW~Q!2TT;v`AkV$>m-gKWo@rJD%gF{C5`!1(_K3K-dj`2c`6@sAeZ zAGmN^5wVU4!*7;*n*;c1qvb_ZJEu+b4*7vhbf9Wk-pzATV@F$<mfhn%O)E6TVmPSi zpB;>2Nq{g0HgtPVwx&7)sq<>IiOk`>dtQSE`+syMdRjixQR>!NSDEO$lf#-?FfWPU zw*_>KF_Zo__l!&9RD+y3<InEJ92$Pw#hyE84-Mbsn@C*a%MT}<GMlE)x^~Kp;H!|7 zHR2zWjZcDfMVb&?ro;jgb>px}Qw!ftG}h_;N4M6lK~5X%(#QEOys#x>1l4qtqa~bN ze5jNc`0ZwRgU9x$p|CN=oE72e4%7Xa<G=r5d1nZv+Y9!sc%Srm$PNYwVQ#eF`O+Qt z8lwrCf@v-t-;O0K3`86@F8=bmj(32qCxf4&=8a}o1T8~u@V59tI^f(U{rY-&dxbJR zFq-`d@%bU;`?Hbl41b&D^L$cZaIURyNub#%wjhG>&>3L=ONIFV7Xtnd9aE;MaES>O zDIgHQy7ubbXLa_A=|StVgM9^b07uW_PF}C9?(Ys1G<5vV^%#xK(Yfj?=itE6$;rt> z0vGFB1*b7yb`p{$0TjQnA8SY3=9i5KVIAvdzaL+1JwIXk*RiP)nn&&C2W!(iE6$}& zH+F=9Pp5>Mn7|Q{i*Uz7=(l-|T~t){`MN+R{}#5YpZ`zW=***Xx(ND`3yOygPx?EU zyot2tGn%Kkvo`(iF>N}-A5V`a@6WOR4#yc!m|n7l+Id=o4F>DrFgm*6Q@-r=fkt7z zbxH;ubigeQ7ApVafD5I<q(}R)2l}aB8Q(W{5v}Hd1n8G`1@9rEdi)~v+`E1EF|03& z$MnT)un+l7=c4|0ZFKJP;2Zh8QGCd;kz?_%j-B%>i+<Lw(0qU7(ZB=rjTbfs%1gtf zo%EI@WjbAvwg5!72&Jhh<ot`9b#+P~D8}H|22O@5OGs=B+H{Oj8j}dNL4Z<Envp_j z*~J>pueVX3cYA=RBIVS%bP`qR!I3Psnx#<52jSiJ3^Plsd27il?}-Q$V%%XdCSfIM zodPq3Hmn;R!cDFU|1W&rH)OV@)CstqZ-<+0FM^-<dO4x)<2UwE(^iVMt;QPx3vfuD z?|%%AE}CL&746I^$Y~nO5hPP>9Aekc>_%E*;|F#Kd)%@vpbbqcg~;KCx8#EI8R(|F zev8+l?3)HllMw(h$9i4(KoDKv!mi&N3HhCfpb)XSb6vk|9RM9CdZ5FBjb5bBm7G#1 zvtI%|j#CglkZmB{<oNW|^7-zKbF@&ljH^=T=k)`fQjA^dA~qzDyhMDM%Juc~A~u2l zK2sgLq>gXYYbjROyVOk4z62iLk!&O@5!N=_uHzb_t~z{^mV0CShus^4nO|!3^MS(^ zN=#FYO2~|sv7j^4w(jk>zH66l$P<RNk<n-INVt&5g1cEd;j*sBI3%U1H&K%%QO_MS zQw4zlk-PloVnzBuV9ZxnOg;CO8VgKwM!d$et46UTF)he{9$ooy8LQ2D{SU}6NWY}t zZVm=Mwo2A(f?7P)wUm+6-4G7bpg{M<pC4hD<-e9%gOR!K);5W6&YSW&&5Zm8-_eK~ z_|l(}piqQ!P8ZWl_P{Bw1F^Q#;Dl=|GOlu?E8*b713$Ag2(14qOZy+D=>H;S`VZ2k zFmR2-Y%Xu624aCBm&t80x+4tTJzFG~mI+OS|BsUBe_Pw+XWDB{l3XvUcNXdNFEFp+ zp4Ej;&^ZkU_(>aRu5e1b>PNj2eyxu&l^!=m8`#Js<sMeBO{J9T3#{4rp3A+N!+Zp5 zh5l+lC1)7Mr+jG5b5^U5EY((cx8uI{yQ?Z6ZFc<3bP}t|$7EmqVF+;pec<(8@D;so zg-l1o3VY=_R9?IHu~XH#==xqZg|5=h1^dvrJZ;D(bg@Eo(;$cgya?aL>!tF$Ht|;G z=3(8bc1Kl!&6n{Jn*tEK3kKWK&4lF?c_6h&I9`o7FWF|JuHMB8QaWi|WAI?^Rpp~_ zkN|Q#y`|}(e=&i*vU`a{O9xTo2swjZ1<vp95AsY$*Y|jx_LB!u#l!`+Hd2=h@|rVS zM{GtPlZuiT5nLcI&7lzj0yi<t+DF35XS_J?uvuNmTn!fZtV{l~v}&Vy)N<bZkY&(v zW~WM^Lxo|gglG#dr_Jhpzc=<ur03(>71X~BEO)z@Zb+0@#vre{o3!IoT--kk8$mjN zt=kE}U;+Us5z-JJTf@5nKf_~}N6jF5HofGpXlIt97S)N2(-l)w<_t#p3=ly5vMrGU z*0LZG-?3meY*}j*Ter*2uv;g+-jH1D)}(<U>cm%{cqmw$4i4T^`l8NUJ`GAB1Ny%V z+^jnuyvovAZ9-$7$~yv?P3u-sSbvL1y%>aE6+ac3AmFT7TNNdYX*O6fk@R?%=X8!Y zey_W5t;C+zXNZq+WLI^X&ijswncltST+c3NMUqF?p%`q(+rFL%ntbjGLVNP{M#fqC zFz~mHw>O4WAPrk8@}IuhH|ubnzScP+z}bHVk9CcNYBBF1su})Sig?2}vC;0y>)S;R z96$Qk@te2EoU+hkS(Did@TXUjXpldF+QXXrGh=Am95GOG`4XsvA<}3S`V7Uu^$G!) z2_Te|nCdcYwIBqEx=>Ll<VVj30QT*|@!044om}vX&b#UoeFsndXrTP*n^j48U>tGG zEwPduq6JLBQ{b*bJZAO{mmZURt&peyS?uWPy**Gm2~zlYwc&f~GZ`-BU(@>_#+675 z`9p?Nl^hblR*}*qwOtQuy3+jk5O9_0Sv}oGz)^$LzAPN6HH><GN-u6ZLX#s|?Bdlv zr{{zq&28$7+;SH|mJv#2^|4JVTYMg;7P3A2BV2Nb_<V+5Us{_5J_lhLB8i&>y%YJ= z%()WIh|OXfR5l4+nGFurP4=)W*wpf(XQ$C-Qu*b}qu`IJWz)GO2Uf1;c~~h)$&wW( zvX8y&Vf`854=tuy)A-|ZJnr3!p0tY8njqpDICHr5)GqpUA7<_E-*V{TtLL)Glm@UP zwsBE?zaq7#7Oai9kUD{z`{yc66ml8Y);9ST=|M|$Azyo+!sh>b{H9Nr{u#d+!r9xB zs(Jmfxw%#DI&E%Q#WhmdYUnt@^t2fwzuQbK=NO|-h?k@Wv6@Jn41?RPT&?dpzg|JY zAJ9EykikF33bS%(d^=X$YH(6Y&K4%_15tt~?nEt+SuD^e);NvS%>cs#(afz?Jyi>; zNBWpTUIlYVVT-IZ;+ELoK2etGM)6`jn>4xz-7!nw<W{GuR31o`>}_Aj@^`0TstZgh zI@lWQc->8%l@>9`9Q_D(j9f#%-o3Ae@Tug}iTNg+gTu3Hj*n6MtM|_*1mUX^;s%gJ z#Qqr4Zo5X>n~xORixGWR>)CkJlCBTN(>Rq%OG}kiR92NKQyQKo#|t)Tpe<(Ey~g$M z`0qFZ{09TAW}6X|Uh!RqJlY5Y1+T6K$YR9DwQ=!4QpI|19M6gu_||A%*YF3o|M5X; zj_U4f$%A;cx`Kj-Kvrh@&=eO6Yv2`FF<}S6cHIhH1+{Z&8|LS#-pcy<5xwv~Ygb#h z>3T?!OD60LKE;3vlqW4JAG=v&(Q+D0z8jYBRr*sjV3!P^q+fJ}Gqk6uDu#7E_u!pD z5F9w+`abtw96%jFDYe>^Q5qB!q*(gXi5m<IjESi(iB2yu;oBWUU}fG0P)~`renZ-P zzByVHB~6Zq!+KU$)md9zeRS69giv6;{};<IC|W$<76lAFjKy+}5(Nc?Gh?GjE^DGv zHdt}T<*X6J{I$NMY%p6a3Lg%#uct>qMdj}9bTLCGBXah!(W>8+Y((O6u+<6D$=Nv~ zBI4!#{N?q@F-2NcQE{f=!x;dSJ<9-H6^-ehvNz>OpyShytf?CD3dW#H+q}}ulS4v6 z8X6i(OD!cOB@GPL87f=xSJ2xMu<F#zmcrlL=S}Ku9jSM}@ZV%L-r`6)$CqA)Vno4Q zK<00DlG+*8M9M#$6u~%lCr5~i?$&!4CeXQmnBcXhxil2qDW6`9%w0TCQ9Rb<J3@ls zG8+G`tgOt*Ap+LAd_THA-mToRlKt}*C#}p<?gq0-4?T(>4up;~IC675e8bC2L3!pq z6|~g&%UoSXPC+}wpVTgkB@^CL{4+A=iSA(1ns2QO&^93F^*-xQb^vC;*#|CPxt$0@ z6QNk-aW$4|@U#4S?hdgQ^Y!o4$lb$464EMJXH`I2Mg|WLPeoZ7=w4W8tgfCKD>ogp zj1iAdNSMFX=$SHEb(QUVL)XegHkVm>?&=W0sUx?MI%yY+lCs6v!?KJi=$CWUY(1j5 z5n8$ldoV;80#ObeG~<%JD6=X_&D1I3@cxse8{`qhv$4nPi<Ip2HaCiIWxe<~l~uIY z!GK#_@&4QucAUiXBdhD>L`J3)0VgNJo6c$N&1}wpma$x{_)v#gW>0EGoeMbx{H>Fb zH9t=BT^#PlOBKYABT@%@OuvFfJZx;5gTb}5;=B98{2%72RX)ecJebM5EUOrPXX9nJ zqf^HDO;jEf+_B$??lwQ>dqN=qr&TScmsZ{1A<8&g3@i6#@7~WPi8t4A9g2SoznKsc zkdWkU_XRIzUSDnt@n+dsTbCCVu~{!wpM>lVMiKD&c-`@Jc|HC3G_n2teJ|dwtKJt4 zncDB2t<2#RN`Bv|DAT*lx0Ak$TlVN5N#0Y@Jb>Iwi`?f{7eB#%D+nt)i_@>w)zcAT z@k^rnLEU5Ayh{}4e|`9><h~^QrtngJwKn?g6RQ^p{J7*9$08A(z+u`~xJv168a3k` zp1^0=u+Q$?enajP2q=;Nnn7W0by^h!Uz=YVt9y`1?IS}Rvjy)XLh6w-h%LLAa{z=0 zD-sFZVU!9Imqd$`${XNJ@?N$y-Y)mmJz<{_4e+g)w>KwZI=T8al@JNtchjBrcpsfJ z4mgbRtMn-8;vP**r+Jmv&QX!6t=z9*V`14W*B0Ez>-jwO4-JV+Nm)(jip;lta8ja< zoXnT`J|7p6gH3h$`X<b1eX1((G!zs>d^zzv`RdJsXLUFXu*LAUOhWg5fHuWoCHUwT zwFC5CxNJ|#A4dJYVzaTfg1#R)Z#5%Dp2#GK@nsY8T3>Sq)2}o%X#xJ>%?D&K6MH3< z!_r|w>Q>RMwyQuB#JsF1mRIS`N;Q8X9TY0?B$$MHjk&oJe&UV+t7jTgWM$<czx;ww z3xPnGXk~FyLY0rCd_m$Eaj?UaJ0<swI-Yk+b+qb{Bw-vxjX6G3(Rbg?6a=N1j|Vv) zgUsinelX9{_U2u8u5Yl<YD-++1xCz7Do!Hb(B9pQKJHiTBIp>Mj;1y`JlU2d>1#tJ zP5RqlLz_cGLt#po=&;*~V#KLfJ~nF_<PSLfwx&tOiEg0oV-Cok(c{66rsh@noue1S z?{w|Va(&!3MQr=20h`iK&^Vj<mY`NUV4S^v`88bE?~tdxxE$7~YM)L#J9pt`-2z<# z{v}-4<E=HfzI9$`Tuly?5X7(4)EAyGfoHM|6hMmaC?>p{otZ1QO`aEnEyoZE11B9x z9=#cCr%?&0gqgb6MG6rvtxK~zn8X-QDas8MKFN8vg?5e&g+a)0AO7yU8F6FLp)9Ev zioN>Q1Z9#5cDaMlzMz)%sTbe6+T=!p?DYDqa)Hi&M3N8am45;o=lRgJLlu_`3<a!( zGB!YbzseHBiH?qI)%aDokO9EYpimZc%}wRz6S*Jw$!Kh=*YL*-4OrR}2xt%w^_;vm zq4!gUpem)Bx5+*DBCkOn6Zcu-yj3QuL5A~GU=}B&_Jzn#eMbhi+)~1Y6=O_%T!XV< zf$Ura6W4?v2$v3yAMD8RG)sHjA86vrM{ih|zwLqS*<<WjWeKy$&UsJdS;Lw}D%#2& zlY`%!KgK0_p^8!Qw=l*qS*GqB1M-G@`2vy6;{0z!HS{4S{TXkiBE+b3%jD{xeV7I^ zpS6u@-_7K|g`y|<%8Sd;i9=8cOP+oJfH;Ej)nSboyB5bO8oKyA)bjK<wAwknANlen zL{z?D9ip%LAW?I-X2o&Ypa9Ir1WhL2&!-y<goDYNkY}f2q}R84xKeu!GH70-H|tP> zp|STo{q*7PubUC_Au%cpM?pc8#1v>rltrEAi&&JQUFo&+j(4%M8e+8#xT;)fzwMq) z8fIHlMMf3PqC+_O5p_hNp!kpZeyyXdwNgT@Y+e2BC{_IX(Q&qsr_I81xSeNq>){YF zDOb77m1v@No0e0x`QhACl0QU3cN%|nR@H6>_=P1bethoKk=Rff{FRT1<-V8wb@n*R zAR7sdw^I!o_;}0A%p|`sV3>2tUAg)0?(CXP#XxO%o<~s-Z!jSpG;s6MhD;na3_=Ai z<_Ht2Y~d0BIV0e4=JF`_A(>ru#WpqxPaQb;>q(N!*gJd<)t{d*iETGHf?}}Ix;4LM zXYH-%<A<vjjE_c3*lI~1U82+o8mV6>W62L%H)g$H#E9aW0hb8GH;t`*`OToJ+*5dG z$y(g#Xg7NU-8LJH1_3_l<d)105;B%K-Kofk#)QxK>u`Tx#WVDi81)1|;pm;rl_=%p z<fNpeoNF}Lia_fSP89AOOyV|fwp~H=A+)80>oLXq4?p>$ZFMgzzb0e2yo9zfo;;QR zZS^@kQoJ~jIDIOn=>>D9Ld&QYswgdOb-yw7@$ng~YCTmH1bSb!e$Z78q>`iK?p3i_ zW4^kc$iC_&(9pCi7`%J)WhOu5_C#^64;}*4YL$QJrNzVs$Hu}xeZ|qy?U{xn1PvFL z=fmH1xh!59D$5=_32`=DyjIW0*PBVckJkXMK74Ms%dH+T8X6j^1Wx-cejObhp!hSs ze824v!*F+Z2le-pcNJ^G`$t=oHF7@nW#-#|qp$wIv7zao(DVF5*nGK#Z#0$tbITVX NAtEbWDX9PR{{cKhWZ(b* literal 0 HcmV?d00001 diff --git a/assets/images/tagging-mods.png b/assets/images/tagging-mods.png new file mode 100644 index 0000000000000000000000000000000000000000..fd88ef5ab18b39d37803b7c7254330152a50aacb GIT binary patch literal 22170 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 ^Wx-E0a^V0L!4xw+Zu?`7=Bn%sR^ zx}{NM<TNxffq|#UNb;?Em?`&*ZEx5sDmGS!oNaZXp{0HF@F5le3*I`+dzmCVH+Nxi zF)u%VczzY@$Hm2E*>L^P!Gl)==zitgQ522W)6{gGAFhA-l5&+=*Jb|3&6~4JOMg4E z;vYP?A|X+Mjh3lbuB)T7`GsxAN!qUX<~yS)nyw;uV`!GYd^+V#dGu(~n>YXb^G}o4 zUQ!wsG7`qqrz5F{>!X*q)~Ba`6+88oxL~B9;@+@l9H2Tsv$(i97^0YO+0}xFPF4Bs z>(_tw>>(E)ZirnUONp-$%X43yn;rOW-B-4W0`6#Q+idjOk|2rXHm=!Nop+k-<nmZs z*w}DitL*$>T$>W_si~tgH84PN^eB^F)kwV8-@(CL*Tr!(!;c?7x^K*WuT#R?cH+&V zE?K<G$S^ziJ}+-EQ>WN-Z7hYF$K=hMH}3QGeD0##OubD7-o?f1zzEpP`wtw5j*gz1 znhHO!k?{KU6_RV$ufOp1O%VDsIXU_EEz9unuCHH>>Z2~{>gpO~^PfH~p`+vR_1O_W zD)v9K&U23s(~G)~HoeBALMdG&3^JWPOCheUqce7!d1!D@k_1!y^*r9eYv%J_wD2&Q zGmUW~7M7NisAyDd#=CdA{grHQ6(uAjl$Dho94<1vDJ&FVBYw%AA#c8ORxwW4ZOQV$ z0l$)xlF3O+9-bVt*5vva0j08GZ!!;$&Cqjd=BB1Ui=C$XE1qKPw<ceoUtU(zPFn8s z>T7S$fAi)H508?bp4S)eefA>_RyVni9y@mI=us6dEjf~Fva-IuzHIF5R$Pjh?aIoO zzaFWns^*hqQ2qS*Q}vyC|LCZ?u5Mg(w1v63Af5=9;Ww7I7Z@ZJ6|EP?+wR@FhhhV? z&?>l#;+kkq+{;sO&YI3$)T=s}$?)6rn`&x}RaIm@l5})*>1tW+9UW@gO!}#(8+lg7 z1#$U?$BwF8KRv(2n!T5@?p<1%>sU(?+TG^He4}^Z{rmUdzrSGeY0uM&NIvV{0I{v( zbaV<NUD<};ann~{oN!#78yag(*`BNAynXw&cOY6?oRE`3nR=?S>`9}OCr=Kon-yx` z)z|-x-f=yk;o-xFqS!>D@m}Z&D=RA{CBouWJ`{km{I3%efxILR-$5T7I#7_GPbcUw zI@y&IFXDF9!f~=QTjD8cvqS{COLLa0j0_2_?T=D7r&MLvkp|k=H&*KT`i$<}0Wd9B zo}ShE+}*u~W{5rQP3GvhI8+-R9T|yXUHR=>Z@Jet1}v5aJ68VMwL<$5QXTKwp@yhS za#~u%?&pvY71fO`U}a^s_t1$m@vStZBNzoKDG?dKLTx{OjN*}KXmHIp@onRYdy~-x z@L9A2(PdzPd&@kc8!i}C1=<dLtB>RvK_fTv*V4FkgZ}jm=dl*1qeqW&a%Q1t$%S)p zDK1X+bhNhSyn8o^4VA3r=kMQuO|iZ(77`r|+@oWnKo@X~oLrpGO<cyoVPS5l*2BXi zBsjRHrbaU>7r&8s^#%F<$6}ic6u;IjEG#&6OFAnnlQ63@zN_k#d&ZI(7#k;LWYAJm zcbQo0DG<N>OG`_0a_p~N^Vv9Hb_HeGoojY0bs=2Ov$~;y+50#(HM>^6C3aMGb@l!e z#Rm@^8W<SZ-deZzk^ItclYBjTxWB)DXh`aSOKiO%o=basJGP)OMi;v~{ueX=16l0e zq`KSUjwQiK;lw-fyYoUdxKoXON9-zl;1xP7eJ(D(apbADx4ODIdIuQF%G#Q4k%JF) z&g+zvJC>F)FJDS-AN8wbWo1QygPVN&_D%kP;>51TrO~mmvGMU11v_yWUEN+hrAh-^ z+)7r~H0rRTqGIf~STbn_c7|Wvc#BuOunQx(kENB>SouQd3$m7`rdO${*GPQ){NxlA zL^1f<Gqgm6g}2rwvM{-*@;;bJDJljG`Q3VmSKFJ{VnEV`k~Y;R6F+hCq*<|dWMt$+ z18}0c`g$H7o=D0gK9ac})fE*Io(%vpOFJKtF@{u|@_q!VV8sh!Y2*{jLqbA)e69gA zQ5^RUtg5Pd_wKxo&ad{7RL(aaMW<drT5gCFsm%=p7}EY|^FWlzOZ-%*Y$RI#;LwnW z^UVF)p`zmA0*w#h;m4j<>^pq;j>0i8GYlx%!QPMt9_JZ-(RlhJN3JX{dIw^hKYjYt zo<GKObB$H~Jqim;w6J~-S7pxKQ-{ug%i6W)Al958^H#}OMn=ZUDkCI>VpH{t#dyU0 z^SHm$hmYrFX)yX0uI*qLbh#4qo=t0(k%ly-s7R2ToBPzM-<TSCd3gXQbxsj<&uarH zMrNJeMdNv!%O<lKa%3i`deK3y$BS+z28hba$>n5c3wUVWOxFalQeG?fSf?R<T06v6 zbv#?W#IlQ<kFNlO*s|+G(%ZMDmA*&k1f;(kRL5UJ7c9HED;M2SlkcAbeiieZx1(as z&CU1wI@;Kr^3EOo#md2P*V6J${brqXWA0S$SytBSo*uN}UbRf^plTyhQd00;vxtOq z2Bf0L(F=Hac~MU2vc9#}{f`&TuB)ka{P>ZZocyFK`xYK8_U4{Fdr)f`C!Zb19$K84 zF}1cN5iv4rrU;CS^TeJ|dpllhK5zeqGvwagJP_rpTj@UxqFsjS69Mpr={PZ+JQvjL z?d?51%kbO_3tgmN_^qCuxL-Hg=487a<VMmjEVmMLUGYgtZ8#^O@^@Sj@pAi~pv-|^ zT$lgGMn%bzfTQ{Q`vXEU2EE1P#H$C;i!pEWs6Tws-QDf$yMOQAy{;=}rluc(FSE+G zTz`Lh00`>9p1Uv3JZJj?CeA4`)MQhTKlZ%4sF;XIX=x}aHTT!5s!`MgHg}3bY?0?? zQF^+C-|)`WPUlvXFZt1<i{^$_N4+kB7<&i)M{CYr%sFx5g!t>gA>X;VxzV_emKJVK zPQ|j@z8W_tY7d`dV<Tax5lFJgB6UarUdznPd|3A?lAVl1Q>?PzCO0q7m|Me7JH@TK zBZKe2LQ;ladD)^;md%YuOP;I}m!{o17}f-Ds&4ng{l=wtO%`lOC;NqUeyWFV{Wfix zisdX`i4}5k7Vf>jW7oau-d}%G0bw)MvlDW2FLH8P&;F@o40^^}3Fdzfe+JaUG}S3` zU|n~N<+n9xOH%<ULF1li&uIPegVL`Oa{$;kC@2UM9^X9e-E<dgZ%#`~3vh>Ne}M@b z?^lV-JZMy+&QMRj)q%r@8yg#~rzbv-%=1}wE32t3k2WX1mUt?ACKw~FJ%>wRHhK5e z5pZh;ZzB_v{MDgwF<1T5D9DbE0u<!q$B!W+m|I#JbsrwP`>fWgYfq1>?1)(wsdpfi zNRd^-Q%)-roAATzN%5y?eVTT*DzDd6mVFt%atvdI9c8|0=@)j}`BGLiH8&&AhvPH+ z!xMu&#k#j=!REl)&z?=8N}2KwY)w(b6tMnP1Z*M1#bt}}oGZPCYsJ6;gUraxyxY7Z zvvaz9J2Nqnf|Bx0W+ojq^|h=YB6fq%3JX_{>ABz3*52r`E@#)wMXP!X{Kde)AS$|* zo>kWU!T10zuk7ZC*!JpZVnEsUmYa{H9Z&~n`Npl!Cn~;tA*B=kcyCJc^yx%ErR&kW zd0j8AZCx|F((G}?z#!q_4uMI4v-Pz#)Ru{n(c9EiCT3=Ct78j<lEnz>UAuM-Yb4l| zZ>)8vOH7#O`ZTom2Ibvg`2kqo+&mV1{aL2SnKRyT1&;dJgQ2{Ki}bHtdGP0|i8C!$ zMS%4)Q&<0s#YR2z)KsMu?tr02MhbHB2vLqm`Fn#^LG64=X6EMI81@aZ+af8qP4xdB zxuvdNMaj4g62JQC!LGfe8}ZHB=xZnW?iy{Cy03D3oC=ar&D5@zzq9|y{>Sm2Yi52o zOBNRw=XC7n+L8^kyS>hC9nqvGy>sVIad9yKO>w2d6)CC5n;-XFMU%l)N=;3TkEdTP ze_BdSO$`7B@M7#b#@a1W8{^+(GE2pmaq}lrg|3RqQ7e(0oSYDA#gqYBa0*SDYtUI% zCCmgJB1oq!*oB08>g(&Pt9|@ulfaPx`oqJ*?tyvmhL69cpe(w_$H%wo={A=ZpXi>Q zmG9Cd(WqPMnwp+o>ttpFTKshW!$?+BGAX}=SJ$WeUME~1vh=wGMntes?g#GnaCeVL zbOVqD@p^HR@9$C7EA|P%7B61Bm<zuq=DzYiEv@F;H<Ov)pX&fS6}7Z_uw9sSOrtTa z&$g-${{5Tzo9e}WnKR_s>VS}JeFoR0t*%F0c;Lf?>g`td0z_LC;SaBky>NSHYv9o2 z<j)jEdO*aibCy$BHtxte@V~06X9_^8@fU7CjEmEquy@+CDQP-U{>O#VX;o56s@mwo zk<(W%B<|hEfR>4eH2JHz;NkA0Zs@(3sFyCO$jMm%%GCX)6pa^yl#(PD-omQQ(NSN2 z-BX*sl<mgWl2b+sVb^lrZmE*e(jJ-*)a2wXCLy-b+&nz{7{D%|+JQnqW&!jdw&pL7 z4}kpcA*E4QR(=EAz&Vzn)?4xp?KtSPG`aY#Tek+E_FOv?4E%atGuIUG9+Q>j+&M@; zm}=G-u`Y9GcnIgQf3bE;OH12Z%jHm3?wXpu&C1e47cnnQ#@s=px9G?O5jjXo%E8GQ z;O7S%{}cqN9CW#^PCioJ#KIyyIXUd*%QIe{mq{?&{{H=ozqPu$ieUf|0SI+%aboJ1 z6#v<?Bi~+}JT2|7U2s=NRW(eKaSX2ol@V9###Qm-!i5V>Jv~Cq%*pknK2ZNK)In$* zC)$B)Hvoe&Myl)UQT=ltZ3n_Qbf9c%>F8ML>+9dX%|N+-Y?D^Ee!`OO^XJdCVeIyf zj(OSHm?V%)0Cg}U&{Q2}-V_(R;V(!?>?%zQCnF~#``zC^yE1DyOm&60{*gO;BS6QZ zqYL614#wO`eD&%#<TAiU6B85plXCa&E%Eia4@^w-q^oh>xibQR=jF?nGcz-4#S=GO zTm(ursCf*0gTlj?0r{UF=X$97MpaAeBp4MP9fwy>0H85(tJXzuVO@4Ucm-OH1;J}) z-Q(;%aE#+^S{jCk4s%GeJqdcl+QQhv!UDEG7E(5;B{-PewcgOr*qFNu?ft4h4O9@t zOPBH>c2rf#RMxM7=156N_4fAS)qyU;e*Vck!!9W;9UT$DFC>J2=kh5kDYZf)I4d8a zj|Z*q;09WG`*uI{3_N0NUtpNOy`^pw?d(gZ`??ouqMzPi5q2023<wCossNo!GP0gO z|J>i-<mz8w)ROG%n`IeU@835OE7@Ikg7wqyCOTf{^v6%0_!Bizi{?tz3{7K8%MyzY zj@@G0Gfxie-ybZS1WGtH?n}r$P~N(CdM7RlTdlw}V&{F*r*-!W;(UE;I<pP;F>t!w z<Rg@vU%2y0OI}II{`14#Po6y4`QSIitt^|fECgrPs)Npcw)`{{6d@QR5fKs4wH+KC z3B4YpyS$FQI!r@&xoh)(sPTqEUCzve2wXyI<MFTFo6q{cAOrtT3c3GDV3tctKSyY) z1b+d&tQwf*&?!>Z*8bVn_Mo6Km`M&z^n1UJrkIM34gmcI2;RAJ)!0EMZbS4{4h{}? zQ9a-i9i7<55&J^zRAnN14Gy;Z`?C<crXk%l8se6)`H#2QK-uc@B<NgO@812)vj`7P zpZzx8n$n03<hn5WIw2uAK7JeK1hzQr3Ma?X-cvxPPf2N8Iy%mJmn`?X(Yw!Fv9q%~ z*8Uwu*ws~7U#e(fkiCM(RkM0oL_`F-*_dIF3?&s6OcD|XS65dwEBVKu%jh&OZ_vA7 z=b<M83P1qT(9i&mmCgKwnYIlU|LoZ_s@4D+f#ASE2q5&JcOHvvYO<LsXI*^iK6<R* zyLPR*Ay%lZt!*Cz1Tt$&O9wkU%_4`?f`a830sHnWJtALLNH;$T!O73h57J`QkX>y} zO&M5IM8xr-ceu-DBACTi@~0Jo2!`2_p>L9{?!LZcHKhDJ+ou0ZTe{jdx{KJx%%h~F zA>X6tuqV|}Z3Ev9F?C4p0M&kQxk*KO8EvG`YrFLFDU$vB0hfLjIZi+*E;gx;%Je;i z0z|6?&2RlRdjRsYd<?(sRCivi4wrZpeyet9tAMrm!v}6Ox6Dj`vOlAvAMHmJn0XQs z5?(6N%Sub%0T_g$93pcDcu-SQ6Hp&=l_(}$aAG>34ii&Sr6eSU@gJ!ubAV2A@!l7m z&OUVzW$~q6a5pw7iHYG108Vx`*Xh#(*v0@96eRxuBt{E5ny0Ab9fIl@UTx%{<p2D6 z$-Swl7S&Rhc@uz33yX=K0_%zK@w-1i-kjY49H>b>KJ@$dd)yqB4=Pp!86J`iR=a#_ zt(MsL+nis2`t%8JvOS@<JszBwrBkemyMVxSQTp7ub42l%2>r3}HDanv-VW2frOC-A zC{c{Pwzf-RVtTfhgoTAi8)WuHd;;9k$Trx0=%BcaynG#WxqR!sUISjH_c=L2Hoq@> zdTv1tqZf9*{3ss}5U@@N4;GanAuj$>m3lYqKPWRmIXz8HGryerpttFE$a#GN_7?p; zzq)V*kVjXSj^S%}x2A+d;;wVwpFDcB%j4Bxh3~_MJJ(*lfB(K;3a#&@2A_BpdZ7S~ zg1tQt4-+TnG}{09lOlqRn75EG>o$ZSpFm?l{abhEUXzmQDz!lW2J)(7)wi>oLt{q! z8M5ePLL=Xt$SRK$^XmQbMSM1<X8ZD`ix*Kd%wm-d4GPtcr@T!qET$p!q1<5n1&i^d zzk9a<wW`3XXQ}#ZJcv45xdA(P5}G%pe0l*pBY1?+xOH?AI~H5|Zuv-x(_c7wF1$9W z=Z2Y?8AQUps{V&y0<8T;kFU|5#=GIg!$GTKh+i8J{m$7>aY`<iQ!vZF(z$+7xTqxM zP8YB<)p`AH4hIJZP`pwg!Qo*OdU|@466BT(CnLzASKWd5M&z#_Z4<-8JJj?%LWxu` zH8WFHleT+sU_gT82+2Q05b3W#!hl)kJ~wy`-fZ{}U`94(W>`U7cyzx$+McfOK6H|| zE|Mn&_7B(|c!8Rxaj)0*CiViLt|i1`V5MkYE7%yxsi|f*Ha2*E(CI)8%HV9^AJz=n z3=s&9^NnKR@dlQb?>0_X`7gGNP_uKxBg)b$P{3nGxqbJirPUUq($>}{VE{@6Z&n$0 z)yU^}3dOCEi+|Mq8^*4csa-hNEKT3cmv*4}lX|(Qhq(C8*gr!<p}-e6Zrsq;CMp4# z_Asf8<E&@|>;{*ndMchA0-d*ZaVb<kf6vaY1_0RC7szV5ryvW>u7&M1CqI7#8F0Le zn6x?cPBhZb5E`e(#!@%fz~Jn`e=r4c7rAL^<Jd>&y0W_@7=tWv^H`{OkEJe1!Y^-7 zL&7tzc?sa)!+YJHpJtdW%mrc=7Zgn6yGx*MMd)FWJh9UxQqF69_$on4n>L?6aQyi3 zk{>&z1J-R~9slnv0A11@cZ`N0*(5*&G;~l3dasS_jiro>pi<C>!3qFRZw|YH(JLt0 zQgLW^g3y94u|^c8rh+l5X{fAcVdGQL-^HqeIR&R*;d*d{p1x6j0~)=OhDM>+w&z;b z<HwbdWFvxu6Y6pfnJi0hhgKWWke=n{wgcRB(65A1L?`C?E~duW*?AJ18|vJ@f^}5X ziDXAx)Ea!DR{@m<v*lZhS!m^}tD#V~uk)DHy_!CH==scyjj`&dFJJzkj)=m!Y?3yI znwna{hY!J`pwvuMeq+6>Ff2Q=^u(P0YTxM?`A+XuVmIU)9o_ThS_laP^ay&-mD>|t z35kg#_0cICw#Kv*NdaSTZn1j2hoVtaBa4=PErj_6z1S8eB+7Fc4JVTN<tK<?-~(iH zGyM`t87~b^M6sVgfAP|#qfUb?8PP<9i;ABT>0wmG)mH_b7An7G1o(|M+V}qUBX@m} z9;mEVJ^5Tp`}gmMif)T1haCYuS$f~m)82R~D;T@Ob&&wlP!xgc&~qmO86*H7#U&)* zHM*?K^n(zwvhyAf4GrC~V+WpALv^(V3>C<*kty(#AS2`6v+C{%yI|W*wWb`Nk`?yc z_!zwF5m`c37ANp>=2f;(?gv*$Kp^V|ut^1dH3dv7nCI_T^w-4-Eo0BuIX`f!kh`;| zl{q9lTn!Fie7xfK4u5(v&p%&%Kn}3ICVmU%2MEk6dzwt5hEda~AY3t!@zBuFeiPMh zficL|J#`03pSA)tcTXyz@>Er?l7RBwQpjLrWQ-H_C^Bs(k~%IuGw@Y3@72#;+8j>U zG~%ykFhp)CR3bFsIyZ=}rbsTn=P=!QG7=;1$n5OdO21<m3uKg(4p<T}=;4u(b2+M* z#2fIJprK%%aiO588s}CwZYEyUDYTP{R55s`R~|?0#*LNy`W2d!jIk=9IFu7L9i39V zC@d#PD&?M=f*xro1+<+lXtDbk(CBL{H&)Pe=I7@DXHGLR!s!H9Lu%#k^mI8KCnr{3 z!Q`nG2;~r(&w3xE6<nYXrpDf?lPLp!AJS{=OwP^CU5ZOfO%;GTij7XJEVMnA9Mwyg zE&;x7{4Jgy<q~>v$l7}P<41nx0(2=jT!PLszm03d01jAlT<1muM>DhvG&M9}BfUvV zngUwx$kdrGUDmyEBd{gy%C1Kh{l`z7$R~Zyk&RoxCMQCIio;?tLQa{IjA;3_P^{3D zXDgwrEHq0aLqIL&2|PcG1@G<(WyK6Xe;x+EI#gKXI#AY74gu?4Jbx~_I!IB(cL5rX zt?eq-S+JOUj!wi?l2dPeWguYe@m}cCTT4CGV5^%A+H&jTkqmu%Dr4MPTn6b&gEN6j z`S{c#Cz!ks0$5<Hqb(oWzrUre&6u>f`wW#I9K)2{q9fuzfBnMNT%PvYj*bilshTS2 zgUOvDw`X^AC%-!$c*Rq^g%0E-3}xWM);oQHkfz_Hq)>>%0Lrr+xY`|lImOh>j5UKO zx9)k;(q8qXyuAGBQ)y-8A1kv1Oyt#ge9)whA{0Xs3ID3hV;$T47@8*qMWS~d5+qRF zw9DLAr_k7SOS{nx@lQ+GTd+RsvehSKAMQ<cW0<hbPu@^d3)f|gf{98-_DSB!-acB? zV@=3@Jy5Oj;A-|Ztm4GOFS|Ze56s5I#_nUlo>kpqNyh6=jExBh3Igx}#FU$LEMS(e zLWuhKv5N0&Ykq3xiBt_Gr5wa0U~Vf$^G*SaKsTlLSUBR5rdRF>z^y|E`5qvCb$y-a zcd)RSf&!yl^}IIo<e8P`)Xi6C^QMBVzp9bKq*?v+io&e1^*M~sx`@|xH8G+du2@Yy z_t{EVC}rz^i{U2cK$EMitb{s9LwW}eCvq7Os8mcsk@?WKwpJVz6r!#v`H`Jds%-+^ z${jwhuBnO1hmD41gy!&!jGT^+*eLw747JcRljS4D*TW_zCZOGzoh)s686J)sZ{Eu( zOroOMxZ}~2QLH^WSTGD0lI(&4y&RKzZ1_-j2EP&@7%4w0?2q05`~wY>`w(!-uV^T! zhK7b}D$f~0s(Gz@OPr>4#l*^CR*#R3?fd5;eCKm#O^vxDp-6|<8oP)+zVc`f>$WK{ z3&+{B(w?#tZYC@bl-Ynu1^_u9K6(^DD?~+29f_fpks$(viH1USGZ3yqdx%s?$hb9K z5`NrbefB$jz)3#;#t}$Eew7A3l0@_7Uym>(EQ|`Cn4)qhaX1l^5(UhIv(5|5Jb*+- z_73egfysC=&aohT<4e~M0%O4ebaQiyj*1Ek4fT;s0FTA29~*B=*U`BoPNGq0$HXxB zqBH=8{y2mbs6M!+!?c2La<y)tv}1)`K2)l-`^Ey|_mz3Xsxe)4cNeyQuYL0-ms!i1 z?#t6-W2|21*qHjPeJlE((}@T|WvQ%`LjPh5#e3;~v|-@qSC8D>>+p`fwY@ve$?)Bj zoY9l8Fjaf|oVl!pCmpZT)6bESc#HS<crK2KdBgPp!&qPMCJF#K>5|ob9jfQ4`XEZz z7iO_Dz^}ymBWA(29TP`3x4qT3J-@gZYMp6KVHG+StQG0_D!eTDFo7_bnwHkx*;#U7 zthTl`G;B7O7+51%mI{@w5(rIQ|9jD_|8-9OUxmJs3=9lf+JK#$`9dLS-m1pjidFt# zzy?=a=Ys*^zEd>NX-XKPFKwwq1=k)|^s{(n5C}6-AAfR;YG3yH?<B|m)8(Z)IPNC= z*7?+LLyTiUeDskdKX%Lsx}^BC$jGiAsY>A3Ah$%0iYX1P1eqXuK?fEwv3QQrkr6)A zrdLR9{j9CEK%54fi#zf>qB0oYNRMR5f&TzE<-C6%D4PVITwYcdKFJAi2@eku_8Aay z{MG_j!1wvNIXhe1n@UQ^GzC0+#scmWygU;7ppI~#^nz*ADa1g4?q{7#pj{%=g0Fgj z1mJhb$M``k&z%PJ<9!TxIp7v~lLb(u!oo;VNP(n>4h`AxV|GJkECcJEAa{3nM_vv{ z6lkFkV-wK@BJ-1n_2<Wi_rO^1>FgXF9E7}v7lOh(Mf8B{>s9`ooX;c%Hy!SyTReIE z_*zm6nhqq_x9RCb;{z(z>C=zMf+Hf(ln{N8A%O;HYh&}O<ARo^rmC`XE{iO42+}GM zQBnCC4<SBYzkZ0}O<9>JHUV2`zFHC}9I6ts+4fAuVR)8e4x?nq7;qWxx$8MAXcM=C zKzmtFFTQIXp`hnv+%~^If!3Qm!Ec^Cew>I6jXr>D!SNAwTdMo@ON5K7xuxY+84Kyt zfyqf=W=m7k&LVHP7mp7dy9c3-f#JcoeGFe)TU*=OLdk+-V%#A-2xg<Pdk5lGFpWAo zJDtJ2vE<mVP$3p3|Iyun%%b3ZWj4TScIJE+$t-9&5fP*P{XubYcdf0xHrE_Yc#9^$ z_942!`@!_F&=EH_9wG{uu#~2!#V|CXXT*|`pFG)9WF-r8nG944$&L*GAU9XnsK`jJ z*8a9rJcL)flvPxyj~}Nzc8o$Cj|<Kj+qrYGF)<O;kg(vfK}Gzieb>Zf7}y%=BYQi$ zh=zkL<{f<|`x+V=FwYQl!51)a!Ta~7S+d|AK#1Of_!s0&e`=m5k-fHA>-2k})iv#) z6L!8}*?EEVX(C$Q^fV`xU(SaQ@`yrBPLeR(y?dA3$D2CmOh`45qoB*&AOf_zjqxl2 z?SW}X7y!Q^I+6RlDXoMmHu?y-t6Tdj2}<os#gB<kE_+Zsot^416@a>Bl3Ktniu6S9 zO?G0dA@c)QSTTm5L2P?-efihVpC3MaK+4$77<O7alXi)-Ed&^eCkM^$-u3tMJIBG1 zpPfy8(KIkR`lQZy@pKtd9;dw_4b?)1#!}YQ_}(j&I}`l-xBe>6NoNh3UArC;mBz~{ z*q6ktnxmr%wp?xPfddDCx0JiPugl8|E;_A^u5d9)Ad%|e>%`5|6i;l7|Ghk_>o1En zVG$7w2Tgh8dJ%Exv<N$BjYLx7VbPV}pkn%&?^VhWj)8uFyj*!Y+pCDg!~u|w<>@|j zu*J2U(i5Wb<q&+JhCu3YaPFTu{DZ6GLA-!{a&~smYPha<>iq`~K4X9>#0jq=L`a(Y zsmB;Z7*Pn|u&K$TF3!%-y|`FdWVTveG-T7+9rpN02FJzu)1P?g-@+A%+HBa6Y47oe z#s2ZM*!>oVs$`Z>Sp+zyNmCCK#(u0{KXm-UDcJas%uWj3dj~iQT*s+b784yUWIrqq zdLUkfYewFvY-3JN{23yL5nP5eG&Cd(3vV%nD8xnAMiXJaVx7@|h+B9eGtxT{bVxDc zLO+NcHgt-gHE6-bi^LWMo&mCj26mL>9}q`S7gVc5Ds+#pm6f3BAzSOcZqrA^p&nk1 z)&N~WdJ8xNLJ0e|_|9Fspy^;9;+wm7Ub%Yp8yeSRaR!fkFnjnMK>C*E=CTO#z{{37 zlc4D0;&O<F|Av-UaYDi$>}-HFqo}z(hfZ8X69);%UHMGy>cs~pf|&yMHZYKEm<dp) z=ll2XO-=9f^LaTq{^F|T7r_#hZryrvkUAkXH4=fG{x6RKl0ekKt6J2sHQk5nsKtrC zDVidjF5oU;B}5FXwsX06@7;^u+|}8MTz+4n{aJXZkMo$kN5{u;O=_O3g0Y)>yL)4- z{@Cy%Up$I(@%5E8H&5Gm@kld#a%iZn+{+8vFH%EjOV6H>2%ZhEU7Vjs9yA`xJpdTG z1A;;l1rjdM>xm1Io!xK4zkBy?kd$+*tT*4^ZcW0PZEkEpb3({2QqRdWqqGa_i46#v zi=P3{QPa}GsK->avbIL@8!=VreWSdJVtHsJ#8s)Qdxyp?EL^h4zKs?H(a>|KCKQU< zj$M0zZkhS{I~yAn_4LY1N;V+m8Du-Ryt&5A%nU&p4;pTK!T|{C_Q1Zt%8Wt8a4Vz; zjN1iPxR!c)dbG5$5T!s85jNoNxf*@)xChVo=hTLXTK)VP6BkE!;zW)6qu*0sTAP}j zV~4QLZj0kb>FGH`WnH!(d4@n4Ky5+>15l+GaW#U@Iy_8u>{vL=l%Syg;o*Bo1EE$R zzC+`Mcq6F?F|{onJsZ_<k%z}^V}*<1Yfn#4P0cvKFp`_V<aHwF!OlucO3=rl&66;| z62O=Rkt~oo69qi@^yzm9#HbS-nBX(``V2|QqATkwE0mO!M#jd?;zX&4<eGv)`;Q-Q zmfHh-d|YOJ@7Pq}Hth%82U+dv>VjMN{=<iag1U=bTpAyYkbA5L>_C@7><lWm^hy8q z<!NG@ffJ7giXX!PMK&P`wks2pfRGT<t%DF}pii)S+Ud8y(}1yn_-cZfBqCcOF)`=K zeb$zygdE3zV8)|{f@Cfld?ld^kk)$!uoD{_>+i21DJh9~Aq?!YGEd}BpwN1Fl)iXT z4~r9)p(JC_>(~8wuIXuM&_xg~kbZu=8Hs}%H!kaWB1nl1@@HTGvj$6r-v{oY{1L`s zY-reOkO~sIM9;$Trc|J3aB4~fi-h};mX^k=EKhVOo*}RN`ZbrM3sbqVk&~FWWJ^m( z_|n*zh2;CISNHGkA#yQ!`4YF~%*&^aV*se1$0G>SI}+chS7>JpqAVj*h2H@+6a{)J ziY+L(U2DWGCszyk5^S@#$We}kl9X2P<@W*NTbZ6zz7UP*7cTp;_-))c7#^S=?hZL! zgm2@5gAsWbLz@^JG=izq=LLBR8}9qJZ&()0QB<(1np$m^ADuY**ilMK1lafm1u+RB z>m?^8;h8RuwSKRx96~RIQE~zOZ*Gpbs+N}MQ;2un*3|4qY#V0(`r^c$+qbWX9YZ1> z$$!Lqe-%0U-Ic;B;P$aUrmXaZ>8zn5Ae@IC17{k;vLGi%$z8g~>Cxp=&bK8t&jHUE zlPZR$8aD7i!}F@%CT4rN18|3OP7{EM=o7pbF2Ivcbou~mKEdsdlarI7;Q&^x)h!2u znN=wnk-BD%&rc82>lWY3s627<#0j{afLC|>%C3_D)>YNkre|jILW*#5Do5G~$^!`l zCOtCUOUug$1bFqQlN>s9T}H-qJ{35v`xT<jNMobZ;0OW^p@0s<_JE|NVE7>+!2scZ zfK<EyJS%vq3;gGRCb!NTV-0Z>1_w`oP(4ncDB=-B;R4Z;Fkq`fNCZW)ke7d6UcQa1 z$Gnm!d7W~-x3?D?*1?a`M-oa|V*MjLriDH6#0gYRaRVaQvPM~18I}_g!^?l8zbLnp z!p=6@+B7;uXV%%7UuPN$H4@9%G)I4g`96PcnXL>xWBqWh*Y?)_Vao@#L#}Ra*m97z z9+N>Lqrl3p#yf{_3LpiD^8j0;4)^ZmV?RB5B!Slr_@3x?b<Lzj9IvVM&aa}MC<uWZ zl%+#=gZhM?W9V5~RDTE~Ck5~e$l;ZhEIQ}L%4~+-vp-!#+#bV!C4O#U0S8SsAoGmz zF`YYS0f347t*ZqfOzNosw#B)Tzf)72U+9ZP5jChk3R-jgxbxz;%84S3!IQj}=r4e3 zh=_g<phph)mGnMf6U6>$NTr!W4pDQzDJoinMw9!5F^HI7$Q@kby#S8`VKL-Wo6~qN zUUYVGnO$|?efH(dxABNNXis9@6UOXpYzc=)r*i+<`Cud9(k&d9f@Zd`tWLs!a22A0 zXtxgEn|lQ;Z{2D^gTie;7JnTZOKWBOArC`P*nK51l3hT+1viY%Qy1yzM!7*Qr=&zN zA8~j2A`b$aFl`!h1C5M~NFIwLa01MatT1|qm)ACK1?lO{#ST5+4h53z{QR(Lqq++? zRFRA#xxyF(>kgc~x}2Ds1JQs<6idqZHZ#*?Ed;C{7$SP8r@K4(%^NcDh~+|XfZR=A zvM)cUkyE^Ro~l4i=71GP<<>40;X4NqRNDFAe%U{1mH7<Y);DhkJ$h8}aQ6YMKjIR= z>to5FMCpizC`Fpj%iK7F_}tM$w1Pj{+mT6#rW?XfYr_@ktE@Z0Dgfc+&q}&!z5LUK zp%RgTyF?d`r07G*0!_hdFd3%OO5Wh4%zNrmx^Ue@^vas}=+X@pm89fkUYvk{IQZc5 zr-50#v5Rn=B%|5QRjPOs49r6eVq#*V@$r$7s{n2sG!}caQVqFJi-~PJu6^3Q^MQ{~ zHSCn3vt{p_@$)<2ujqW}U?`1+uNtSwo>dyGD)Fv8HVUCW|F1e?g7+D+!wA=M?+4b( zScT3b#n=q!4>ZI`x!<fO^AE>$>?%!up2wc)z|&RRzjB&5*>Z~ST!XFq>Hdy|W%EI` z?%_JCEw+&Z%}JeJuQ(T*EzHb<mI4?wZ6Mrn8_U9%z+MOIg*r6aBeh-jp6uw+(A@{9 zWX=SGZW7h2@o^6I_rD*XYinsSP!b8tY3|PN{e<Ip-7$r)Uq2|5%6jApg84))?7Rym zF3xdaxDdtok&*ApsijL{OT6zflK_tpF;<AUaOL`ScI?@U7hm2Z{j4?eVx^ubTU{Hm ze?+raeK1IU!-Hkc;7MVD;IpHlFUYCmOxy@ji;f)Ngi$S6nrMzk4vBH}^DCJ%=C;C_ z85#8p;b;E+BKc=00<Dn2kBGyEO?)-@?b}sg*<^`lS6UTB8FZ(l@P8r@Rxu&wC{R2? z8zVto|1M5zfcloc-UHw&m<SPL%gM9^Z^xg|pChB9xF4NYXMTHw#fZ2DN5rvdG%fYv zU{87cg~deM=GqHUBS=Q_`}M%>uAQvIZ{Ox&CyUE~jN*X{(D=i32S`1}q5TooQSSB9 z7e&K@Hr+Bc?uS7nan=*1Ft?3!TSuca!~_JofDfTdQcqs-qJ8dPn*gln=j&_Q8u@P= z?{=Jl*9~m9Z^Fqb+qv7kh^N7t+xq7?!y5>i*f1vFpnaoK#7U4rL#UmDjcvR=BYLCO z`bB=-!em#-R_%~oIH#T{^mfb|9AH9xXZ09UsH|S6-LF3$4fXX{C3Y5;SJrko$Ae7W z!}xE?+FHB+qly6CTa(31d^bi~9&RXTNJ&-x`0-K{XB*+N03g)mSl!*@U^|>wyBx(r z1S($7avf=PZ}W=FKwSbp8V%5F6#$5=q<LAzi7P?=BZ4ZY<IU^W5IG~*rMLJB0K$mh zO&RS!(AK+W`0w8`lll|5rbziP#ITPXd7YZt)i2HViiXxc?zW-f={}k><UU03QwP@v zz!N11Ub}(ahChLC>4Q7K4qI6NiNFD1XUPR#kY2Q-yxiOf-oF6ASUH666c9Msav&a@ zLCAV62f7b>KFB|;3?$M6A|t7z%WTD;0h8fO894><NR{-96QMytS9ngJKW_=4A5IM7 z?T93x=Ig4fUt8rNC5C~CBU)^%tT^*<k&o}r9$z>yXo7+Q0%+XT%e$a^7#kVMM_n9) z34whNsKIyfB92FZgOeUOfX%24YUAo!ggSzGfBN)kJ?FS9(fJ6+MIiKrlp_^YKCl6b zt*_Wg5wqpQMH!F}m@2olW!&;q?r-i*({E@LU7rNps{5@Y{!Ez-r+jec6^{IyU)_)# zrWUDTvtVwCK=XvKghVqSLGI}nRNSr$rrGLH^sNBy|NLnw3jFy~8(<dr0PYPgjFXd7 zoFu+cZR5-I&%zvJ$#HVU+xs8zC(MhE$QQ(5#RaHH2-|Stj2UAPOru;VXVjl$Nubal z4EUa&kpWtStm!^dQdMn<Fq9?kjUOuV!h!>&W7Hh+9l~YK;C3+^f&K5onT?C<g+&sX z)ZOz5)ag5(AQ-d>i#r4_4jy+oM|q+rFR|5!Lx{xT^mzlw0SY0Fpu<}qpM6tdD>&zg zCokf;;Y=5xrmpS`(>d%;7p5o>=iEpGd?i{g18+pbprRqEgQ|$s|L8aocKH+zctMyV zddPBehF!z((6!;xU`!yc_Wb$5Va8OPh3oTNw}N5`;SdDL9pe@RW9+k;jLb8cGjmHz zR3!i4Ve{SnsejK4Y)uJ~aAB7@;E_%PPIrhf=wmNv1a7IQAWO0hb@282=E{n*k0iHI z6&b?P7-L}1g6&e-=*YN@)s+?GHkt;?@V51ReO~Zaali0a(RZA0Gwe6-p<ALib+acz z5^>D}ou8#{Y7!ELILzf8h{IlB2g@L4^@7lL<iK`XTSF@P&oD8;zyHzI6`8*-1@2&K zx-i|>S5Yy5QUkTO^f-ZBB2-QRtTY%T^nIdAkH{}4&9NKm>c?qlCa0%~=N=K;8XYz5 zW?nVVX?7x>N1}!O0Ma=oCu%?Z-2DqiTo&*i1~u3W@q+tP&l0IZF~m4%8bEg#9F4I; ze7JYuBMfbb2UysZ)m2CW88|2<DCi2EV`^`F7J)z|O#EDc1<SnBL%`j>p4TDzFa^n= zMKr{V1<((9%9Z{qpQ;&|M<l8O=Z0F+nFO!t>%T&N{tu<MKL}I~4&@R%#e1!Zqcf`; zh>MuS=b1J$2FWbIXLnff6;wIaJ1vKXA>eu(HG;$l4iRMz3YHx0t?s+$aeD2O-UH|+ zIEH{gCemvU<v#spN8l(hFtCXlp7iYUG8j0RDNeCKL4@d8zPY4z=iO-R;N+w*mJ@L$ zHDzURoP%`25rs@UHYiFmB3}cGn6<ot-{ZOip|`z)FfXgp4=ov^{~*STbA#C^3v?Bv z?gFP(_Eg3RyCh)DfuKPR#E%dwF#0A|)AI`l;b*?Np6yAViI)4{IU)X^bpHRIeD|NC zf&Y~a@&Cm^_5X7j|F6&Z|DUD%|H;x3KWAY>2?~EU@sk{8iUO%?cy52e2L$XSe6k=~ zPXEIXa@e*&$g$63Sx2p7C!trn>N(%b*w|n2%R1{^5beAR5#^o-fk47N@B*=ouO_@` z+UPqCnFr;B=>jVH9UR#SuP7LJiXwohVEsV$p+h*6hDO+NTv@yd(H^n&NgjLqd3<gG zWEnE?Z~nAyFxVl%L9+)eg2P2Fj!-2BQGh4}<iS|PiNfd4-H{B5_<}*>xv^rq<_wtt zk(DyH<-6+Yo$%4%t@OMLkY|p*Xx0J+J25d4PWbTXs7#7|;ZH=%wqOY1oC`#LDB?L! zp6u}eWY&T|FNkoagF`O7;<KeU2{X)>O&qdmh3?@bd=|Ltx98Lt+TAdQUtM|RkAw)O zHq01!^sqy4z6~esA3uHC7|mymd;u^8J_P2pH)g6;Z%HH>F`a{K#5r|2xY~$B-or%$ z4!uLnR87qZ5Z0=p3rP%sDZJr3jhrWqBVGs(V|;rD0!mp!$?3zHZu|ryW&glH4$e3g zJ(Fa_8FE>3^KqoCk+u+8IkfXW-@d<mZI!UCwxJ+^z*C5062e>3#Nzz>1&aa_BMAcr zE-`Zes;$h%<Q)Svf`BI^EO>b!)2F>bt=W1tg!uU(&f}05R3uh0F)yT5F}JN6%#4gK zLe$1^60bs3ig<_v2O)9lH%`Ew`OKL&A3q{v8xlf{9a~#l6E79B56aiys^#5;UYV-r z98`34WzMq(R#sDZLx|EqHF<GJQJNv-jK~wfv)awoY3by|M2Y1|%dg+R!+63cD6GPy zg$@O2cZxkaHnv`PabZkJ{Mm~a*DWp2KdsQfl>);-NDr@N@~#RG3=aOXc68S#t%Fud zI+lnK<4C`alM~L`%s?H)c|fpB%{m^)yTr<XDGiGNVHov1^S0VdrqiblK_`$6vuJ-u ztUx67QNZ0XIYmWLE<c-^E)&z}XT1^f?CR-pLrMjr5#q*T2%K!(0*T?&Vj?)7B<=xa zHW6TGC>k4^o5aO}q=XZY`4QhcI{0{bmk@%<WvYQGQrdzj*haa7lOk9GCVU0J9dfdW zdjjdP+t)BEmQiRy@gSbCg~^WK;XTwL5I7D5eIzB!kV=?1;4DxEys;J!C-^SFu@n>( zk*{UzKB_#pe7W`E2?V1ya^?a+--n#mpbsuQ06B)^#~{fT%FM(>E9~5aNMvW{N5@d4 zMy@12Bol9x!a*Bn;kc;oZR_dYM+t({qW8BObQ^VVbG|!J%YNnc5#yb@2K!D>vh(k- zqE*s0JbfwAdhM$Bg~)3%y$5-k<-Z&Cp0U1lsO6?%n`=c=LiUi=z*}kwB|~lAnl`D& zl{&YNg_V9-9@#WJlyupa;hK}0SA01sI84lRf53e7ys%qCzduJL$>T5hJdSDi1(MgJ zk1m~#Az=Wfwl0|kdAVv}@CVU6^q@BLON35KUhv0|ki=W5Wvj!{Ombmx3R0ERI&|Hx zr?l?)ggAj&6sf{~kTHleJ1*lRD$tLZ$oE}u#ffZ0e?Qa0oi4-9gUiDf%7!|CGq~pw z!^c-5R8lv2qcf6|nc<J%``G5LrDaJ;l_T?c1qI<aIK<2>y3}bnjpPwT5<>%nTS`i2 z8{RN@)9HWQL#F`a93i!z_?!!D8?&hPiA893(1{35(77P%<KzH1%P67@u$bMJCUG1D zd2C{?RW>OtGjqvV7)8AP$Bz@P6fsGOu2K%m5ygg_O=_EY20j-BAEJPOIAOA<AfVa^ zO#EAAr2q}-i>peyx}tX(4-nMPhh0rvMK~LfSRzusy{k(@MP+Dym7ou07q5gjgpv%g zAKtrOu4ywAl<&Qy56N7A-@KK2@h3IiezddCPQ{Gg3AA#rZ+Hvs62}wybmI7N5~n@h zWa7;`IzAl{CwaWzVh?_B<97XJ5(Y}Pchn>d-r|oh?PBo0@%FvRDQ~j<M|<~fO@l{A z+DKm}c|HBl^e$=QZ^lH6|5txOJtw{^SUWfFT+maYYLAcg$-T)+-D@5po+q-Uxg0IM z$$UBLHk=OUIB(c||0qTkz!_amw)4U3{PY3QsLi@Cfs>v`Bc-{dh`%U!lb0`4J6H7U zw`b(5`;LgSP~KGKVUG3i{luDT%P7WxD`%`RCtmu6FHsN3#95Tpc^GdZwvR~2>c)E3 z_|skr2Jf<B`u8Rq7nzo-lmdhW<W?%Cb~1Q3l~af&UWj=qI|OzQ{o6ydFVCU_b}J5P zK!bq7NBDvB0(^WO?d`WHRd6cbebw%<IG3=nI~onb;}qh|OYUPy;gXEaa4#PXprGDC z<3-ygK#zo*5582@Z$q5E;F$Qy<Jrz5;>{!@$zPsS8<nk%r{g46e*O|9sQ)-;O?Z!> z8-^Ug86OD(t$POn9EgLRy%g;Xr%yd#8R815C@JN;?e}AN>Au(hj5devAVAY_E~^Be zedIOsNRmWEow>ZBDr{CSj&I`O=VbEtO5Q&e{L)h!=lm{4zN}p{sVYpV7(GC?FI<CH zOH@(3cw_KGv+bYuz#hfplrKdYb&@Fs-5+cn(PP=yp7b?SE|jKNVBu`6@yJe<;QO0v zp+ZhEz0*T8M%t=fG+hA(rUmgaeCj7%pX|_gG?0HSdw%%BI!&A*-_!1=Iy8Io%<?TC z#5BHntKc``)O{tyB5g*TYQQT_W^Qj)ZTLDjlY`3eyYfSw%eg00LfJ({bveQjti6%g zOt{}VhJ#^m%rvt)qU%ivO%sa>DHH@v@OdF2SaUlNd^1F3zpJZ@7+L=srxYRPwFMLb zrD?~jf&wQTW5(e%^E`!fJmRAad~H8}kU#$Y@N<Llg<(18F@v=~I$Bo`ma-_kH)>jy zD&HJ(si9;TdH9*xgvTp^d|v%|5$V7Ojf9jCgEgAC{M%}}rst^R$Iq|MCgfFT@7S3t z-k`VGKAo<AgHpLZI+R5}zP0Dp;~2+O^2A!c!C7nh5M7=Cce@_#wYLjHE;;#|83kup zdBt=Wyqw-$4R<n(dR}X^p=lUlU{uW6WYbfEWx8%x_lN(%*~|WY7Zv&9noV=n&%<a- zF<V3W&OA>uLshXm2QDYhH5V0WrYg@l3v-0Kp{b4i{fiQY{sJWqosK!g3~qNT?G6U- z<TUD$L-~D9huMP<u<;zlpHKgK^m*zZQ6ZJD*N@t9oTObZmM6Toc+IB9u=24s_k#an zLUGRv57K~&V=Ef6lO7b#I|sjBpZ5}>D&V?4KC@f2P-H4(x;*&&?>GAe!q=vr<~<VU zHMDT038?(NzK`&HWv9r!MlJR|4AECeW;6~G-n(q-QOCwoIk7y#`lvEL>p1g$=O=o% zCwqS}=qSG!x>pQtd_>#&_pEb9Mh041>zD(D8(>S>%$Ebu@qmg7dZutBBkFT*i!{AQ zE))aEXGQPc$)~g;0-+7dv*^(&Z#p}rwuAUILQ!$TC%LLoUcW2X_~i*7h3uvuzViAS z&hlHP@ZE7<3c^7JPQuE*eOzDrUijCKaYt3(I4n5T`|03e<DIPGy9u8)n2Y&lJT1fs zHz;G;H1?BA`VIWUo3$O%Q=yr@epsY}o5MoK*T^GHa(aPol>3*HjTi$~LCi~XC*jz1 zw@H`{&UgZgQ%Yf0iL6iN5Kkf@zFs?Yq9X%mIx)F0KR%27`kR_|Lh5EnezA5Y%)B^Z zms_dIu;-yHlq|O6aH$TDoIjZ>f4$8iVP{6wna<B*cV^Z9(Qlf9F;5_?y{%x8tHQ=r zZ?v+{g;9Y_+RIvO=!D%m;quiS!u^U@vcZP-M(#)BTLp!0%_jZrh$>dKer4$|Ut^rQ zGMOwCrgv$1(u_XPRzr*D@Alin93h%X<a;L!uFY+7rZCsk*7oFC9J}7?O_rgGFdWW9 z57`M2$i(&Qy7W$w1zI1t;8%%HxT2#q(pL1V<X)=u%g$bY$aLmR$$WzlI@s>}7)SV^ znr8`b;jmMGy-FfdXX5;@T|oGk>N17x!yt#k`;{`3HlpPg%X_NSu1fnqFK3d-q;tr8 zcI+|t%fR{-Gud}t17dGz-^HY_1V|^9o1Ki%NV9dNjiW0b`M&=_>oJ+%IU{n;C_dYZ z6NOzL<TjVWuAF5!bNSg>G8WnA)j_jjg;t~rTrXCpy&fwEQ=aR;5a4i_!-rz{oRn9g z;gr2|^3g1i4G44)nNw4Js*N)7=^Un}Rr(hQ_p6O|-p3&aopMi|^fvR0Q8-2Q=(9d| zBo0l$)n9b=unDvk!Kt%+gG%3#I5!v_Rt+%%urLq)vy-5I;dqJeG?MyW<3Cu_+oHn5 zN0!%x1O<~<>7__SCL=V;-^FyEXuLDR=FRu+uf=fC?|b2Gzt*Piy)QMcVolKqkXt3^ zn7CEGDYN`4{(i$)|ApgSw>;CHxmAqIlG|iP#1yeACZD7W-C_w7O`tWWd!O>XNq~E6 z@pcDg?XGT$a@r2=lm)SEl{@uKGQ#ntm%kmekH9U9WaK#X{FL|Aq&d5iEpEEFXQ}V_ zWS*PmQysggyz{yd>;rx8i<TWDlj9geY&Cj@+2lF;tcBz~6s$c<WU3AI#tRf@Lw&Mi z7487hs;ag_k%V1;Xb(PiN@wP&JaY&u14DmmN}R!k<K}tz^bEQ4RGeD*NQ=lNHpAp+ z39Ug=G=_{jGv%{BmPk=_)d(NF*f^q;-iFxI=WE1I2})B=gCY#py7SZLM|*7z_A^}6 z`SI-lUq$R~*R7Jf{U5{H4&8hoCd9=nP9jBHl5+Szfs^)wz%s9WKScHOD%y>Fee>c7 z(;Nk(_YIcgo{BOBBGS(QK^S<izN}JwhTqdC<=qZt_dW9V7Iob-PmZD<%c8~a5`ZWa zVkgXt_dmFQfh)Aq@1xq`>qky9cqfovTFSqT*EijNGe3?9GM@hjBvO&gx_!!<F;e|J zX-5wo>;C)b8f4-(!8BM*@M%_@nkD>PTt^6h7Z!24bVw{#!0;mVBaiz8shgLpO7GnB zTL0C&<QA~@hQ*ic6=CN;-*WrbId=bu*xX8_C3$YKcmMDBWw{+>J1M%$J-&{5Z(Y9n zJ<_N=acaj-N-5@^X)%A}T(Q7xm$%hRLQzixKYhKY-FTU#{>IEC%|0lc*v3+fM*_YZ z=5!H$FS<%!y=uwZgJcfk-d|{EK7U3yyuaZ-nXl}TIoVb00wjEKLXvX7j_%dU?GxjT zJ#iWgNoG;WW6)K98gZNDb=!P*zx>;Ek2s4jD<wYj#10>QG-Q``@5Q_A>E7~!7tcLw zhU}Qgui<2x_-hiws=fO%@0{{ZP`9<smO1msu8{D1S>h_U8rxQiQ<-fcoC+K~c88sD zV~_SZZi@S@ywy$zscL6LIJuJTwZ~$P5Ju-_ii8(-*#ERSRn%CteOThKMo~9y03$vv PlW<K+K{8WZ|KWcD!c{dN literal 0 HcmV?d00001 From 3cda8411bc91450c2f2208a4be6e18d7e91d37ea Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 14:49:31 -0400 Subject: [PATCH 11/38] Screenshots in Markdown --- .../{editing-mods.png => editing-posts.png} | Bin .../{tagging-mods.png => tagging-posts.png} | Bin community/sharing.md | 18 ++++++++++---- managing-mods/git.md | 23 ------------------ 4 files changed, 13 insertions(+), 28 deletions(-) rename assets/images/{editing-mods.png => editing-posts.png} (100%) rename assets/images/{tagging-mods.png => tagging-posts.png} (100%) delete mode 100644 managing-mods/git.md diff --git a/assets/images/editing-mods.png b/assets/images/editing-posts.png similarity index 100% rename from assets/images/editing-mods.png rename to assets/images/editing-posts.png diff --git a/assets/images/tagging-mods.png b/assets/images/tagging-posts.png similarity index 100% rename from assets/images/tagging-mods.png rename to assets/images/tagging-posts.png diff --git a/community/sharing.md b/community/sharing.md index 722d461..31a53d8 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -3,10 +3,12 @@ Author(s): code3z (@code3 on the forum) Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help from the community. But it may also mean you have to respond to bugs in your code and help other people use your code. -## Managing Mods +## Managing and Sharing Mods using Git To share mods you need to be able to manage them well. The developer tool called Git can help a lot with this, and will also help others contribute and make your mods better. There are also some other recommended methods and formats that can help you organize your mods, please see the "Managing Mods" section of this guide. +If you use Git to manage mods, you should still create a forum topic. But you could replace the code block in the forum topic with a link to the mod, so you only have to update one place. + ## Code headers Putting a comment at the top of your code helps people understand it, use it, and remember where it came from. Consider using this template: @@ -16,11 +18,11 @@ Putting a comment at the top of your code helps people understand it, use it, an * https://forum.vivaldi.net/topic/<topic> - - - * Description: <description> - <If your description is long, put the second part here> + <If your description is long, put the second part here> * Filename: <filename> * Platform: <Linux/Mac/Windows/All> * Version: Vivaldi version <version> - * Author(s): <Here you can add your forum username, and your username for github or any relevant app (also add any other contributors here)> + * Author(s): <Here you can add your forum username, and username for github or any relevant app (also add any other contributors here)> **/ ``` @@ -47,12 +49,18 @@ Tagging your mods helps others find them. Use the forum tagging feature to inser 2. [CSS] and/or [JS] 3. [Area] (what area of the UI does it affect?) -> Please don't make new tags on your own! +> If the tag doesn't exist the forum software will create it - but please don't make new tags on your own! Only use tags that are suggested from the drop-down. + +![Tagging Posts Screenshot](../assets/images/tagging-posts.png) ## Describing your mods Now that you've added your code, titled your post, and tagged it, you need to write content! What you write is really up to you, but be sure to include what the mod does, how it will help people, and if it has any shortcomings or bugs or does not work with certain settings. -You should also include a screenshot. If the mod does something that can only be shown through a screen recording, take a screen recording and upload it as a GIF. You can find some screen recording tools in the resources section of this guide. +You should also **include a screenshot**. If the mod does something that can only be shown through a screen recording, take a screen recording and upload it as a GIF. You can find some screen recording tools in the resources section of this guide. ## Editing Posts + +To edit a post and update the code, click the three-dot menu. Alternatively, if using Git or cloud storage, just link to the file in the Git repository and don't worry about updating your post each time. + +![Editing Post Screenshot](../assets/images/editing-posts.png) diff --git a/managing-mods/git.md b/managing-mods/git.md deleted file mode 100644 index 20fd9f9..0000000 --- a/managing-mods/git.md +++ /dev/null @@ -1,23 +0,0 @@ -# Managing and Sharing Mods with Git - -Author(s): code3z (@code3 on the forum) - -Git (pronounced like get) is a tool often used by developers to share and collaborate on great programs and docs (including this guide!). It allows developers to make individual changes to the main set of files and merge changes together. - -To get started, you will need an account on a git hosting platform. GitHub and GitLab are two popular options (you may want an account on both, so you can talk to people who use either one). - -When you set up your git repository, give it a name like vivaldi-mods, and choose a LICENSE and README. - -If you've never used git before, see the resources page for some helpful information. - -Like a normal file storage service, the git repository allows you to upload a folder containing your mods either using a desktop client or a web client, and to get a raw link where people can download a mod file, as well as the ability for people to download a ZIP file. - -Like a normal file storage service, the git repository can help you sync mods between different devices. - -Unlike a normal file storage service, someone can fork your repository, add their own changes, and request their changes to be merged in, thus making your mod better. - -All of these things make git a better way to store mods than copy-and-pasting them onto the forum post. Having everyone store their mods in a git repository would also make it easier to make a community collection of mods and/or a better way to install mods in the future. - -## If using Git, should I also post mods to the forum? - -You should definitely create a forum topic for each mod you make (see community/sharing). But instead of copy-and-pasting the latest version of your mod into the forum post, you can just add a link to the correct file in the git repository. From 398494c468c1114474e6a423dc0394230fa6f7f0 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 30 May 2021 14:51:34 -0400 Subject: [PATCH 12/38] Do the asterisk the "right way" --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index 31a53d8..b3d7e01 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -18,7 +18,7 @@ Putting a comment at the top of your code helps people understand it, use it, an * https://forum.vivaldi.net/topic/<topic> - - - * Description: <description> - <If your description is long, put the second part here> + * <If your description is long, put the second part here> * Filename: <filename> * Platform: <Linux/Mac/Windows/All> * Version: Vivaldi version <version> From 1039272927443c0d6abae93162af7d353d79a32f Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Tue, 1 Jun 2021 18:13:55 -0400 Subject: [PATCH 13/38] Fix: Guidelines and best Practices, Phrasing --- README.md | 6 ++++++ community/README.md | 29 ++++++----------------------- community/asking-questions.md | 13 ++++++++++--- community/sharing.md | 31 +++++++++++++++++++++---------- 4 files changed, 43 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 0aa38f4..6b29565 100644 --- a/README.md +++ b/README.md @@ -11,3 +11,9 @@ for them.** **When a modification stops working, do not blame Vivaldi and instead ask the author of the modification politely if they can fix it. When reporting bugs to Vivaldi, make sure that you have all modifications disabled.** + + + +Community + - [Sharing Mods](community/sharing.md) + - [Asking Questions](community/asking-questions.md) diff --git a/community/README.md b/community/README.md index 7ab674b..0cc784c 100644 --- a/community/README.md +++ b/community/README.md @@ -1,26 +1,9 @@ # Using the Forum -The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. Git and Github will also be good tools for working on and sharing your mods. + The [modding forum](https://forum.vivaldi.net/category/52/modifications) + will be extremely helpful to learning how to mod and getting mods from others. + You will need a [vivaldi account](https://login.vivaldi.net) to post there. -And don't hesitate to make your own modding repository! - -Contents (for drafting only, to be taken out) -- ## Asking Questions - - Approval: - - TODOs: -- ## Sharing mods - - git - - Approval: - - TODOs: Add more repos and official section - - Code headers - - Approval: - - TODOs: - - Versioning - - Approval: - - TODOs: - - Tagging - - Approval: - - TODOs: - - Forum Etiquette - - Approval: tiosgz says remove it - - TODOs: + Github/Gitlab will also be good tools for working on, managing, and sharing your mods, + and will allow you to comment, contribute to, and raise issues on other community member's repositories, + so you could sign up for an account there. diff --git a/community/asking-questions.md b/community/asking-questions.md index 8f5b377..ef8b27d 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -2,7 +2,9 @@ Author(s): code3z (@code3 on the forum) -The [modding forum](https://forum.vivaldi.net/category/52/modifications) is also a great place to ask questions about modding. Before asking, search the forum and the internet to check if there is not already a good answer. + The [modding forum](https://forum.vivaldi.net/category/52/modifications) + is also a great place to ask questions about modding. Before asking, search the + forum and the internet to check if there is not already a good answer. When asking a question, keep a few simple things in mind: - Use a topic title that is descriptive @@ -13,6 +15,11 @@ When asking a question, keep a few simple things in mind: ## Asking For mods -You can use the forum to ask someone to make a mod for you. But remember that it is a big favor: if they wanted this mod themselves, they would have almost certainly made it. So be patient and realize that you may not get an answer at all, especially if what you're asking is hard to do. + You can use the forum to ask someone to make a mod for you. + But remember that it is a big favor: if they wanted this mod themselves, + they would have almost certainly made it. + So be patient, describe what you're looking for clearly, and realize that you may not get an answer at all + (especially if what you're asking is hard to do). -If you think that what you're asking should be implemented in Vivaldi directly, make sure you have made a feature request for it in the correct section of the forum. + If you think that what you're asking should be implemented in Vivaldi directly, + remember to make a feature request for it in the correct section of the forum. diff --git a/community/sharing.md b/community/sharing.md index b3d7e01..d473e55 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -1,24 +1,28 @@ # Sharing your Mods Author(s): code3z (@code3 on the forum) -Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help from the community. But it may also mean you have to respond to bugs in your code and help other people use your code. + Once you've created a mod that you're proud of, the next step is to share it. + Sharing will be a big help to other people. You can also get feedback and help from the community. + But it may also mean you have to respond to bugs in your code and help other people use your code. ## Managing and Sharing Mods using Git -To share mods you need to be able to manage them well. The developer tool called Git can help a lot with this, and will also help others contribute and make your mods better. There are also some other recommended methods and formats that can help you organize your mods, please see the "Managing Mods" section of this guide. - -If you use Git to manage mods, you should still create a forum topic. But you could replace the code block in the forum topic with a link to the mod, so you only have to update one place. +You can use hosted Git repos such as GitHub and Gitlab to upload, +manage, share, and collaborate on mods. +See the Managing Mods section of this guide for more information on Git. ## Code headers -Putting a comment at the top of your code helps people understand it, use it, and remember where it came from. Consider using this template: -``` + Putting a comment at the top of your code helps people understand it, + use it, and remember where it came from. Consider using this template: + +```Javascript OR CSS /** * <TITLE> * https://forum.vivaldi.net/topic/<topic> - - - * Description: <description> - * <If your description is long, put the second part here> + * <If your description is long, put the second part here> * Filename: <filename> * Platform: <Linux/Mac/Windows/All> * Version: Vivaldi version <version> @@ -28,16 +32,21 @@ Putting a comment at the top of your code helps people understand it, use it, an ### Versioning Your Mods -Instead of tracking each edit to your mod as a separate version, its easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others know how up-to-date the mod is. + Instead of tracking each edit to your mod as a separate version, it's + easier and sometimes more helpful to include the latest version of + Vivaldi that it was tested in. Along with the last update time, this will + let you and others know how up-to-date the mod is. -Because the forum and Git keep track of posting times, it's not necessary to include the last update time in the code header (but you can if you want). + Because both the forum and Git keep track of posting times, it's not necessary + to include the last update time in the code header (but you can if you + want). If you do want to version your mods, it would look like this: ``` * Version: 2.1 for Vivaldi 3.9.2289.3 ``` -If you want to keep it simple and use the last vivaldi version, it would look like this (see the header template above): +If you want to keep it simple and use the last Vivaldi version, it would look like this (see the header template above): ``` * Version: Vivaldi version 3.9.2289.3 ``` @@ -59,6 +68,8 @@ Now that you've added your code, titled your post, and tagged it, you need to wr You should also **include a screenshot**. If the mod does something that can only be shown through a screen recording, take a screen recording and upload it as a GIF. You can find some screen recording tools in the resources section of this guide. +Good job, I hope to see your mods soon 👍 + ## Editing Posts To edit a post and update the code, click the three-dot menu. Alternatively, if using Git or cloud storage, just link to the file in the Git repository and don't worry about updating your post each time. From 2a43bac6c28c85f7baf7fc48d5fca282ff52b9d4 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Wed, 2 Jun 2021 17:05:30 -0400 Subject: [PATCH 14/38] README resolve conflicts --- README.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 6b29565..a8a944d 100644 --- a/README.md +++ b/README.md @@ -12,8 +12,12 @@ for them.** author of the modification politely if they can fix it. When reporting bugs to Vivaldi, make sure that you have all modifications disabled.** +## Contents +- using mods + - [installation](using-mods/installation.md)—*I’ve got some code, what to do + with it?* -Community - - [Sharing Mods](community/sharing.md) - - [Asking Questions](community/asking-questions.md) +- Community + - [Sharing Mods](community/sharing.md) - *I've got a cool mod, how can I share it and make it easy for others to use?* + - [Asking Questions](community/asking-questions.md) - *I need some help, where and how should I ask?* From 6de4faebdc5ff0420ace2cfd49fc94c10e5ae13d Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Wed, 2 Jun 2021 17:23:32 -0400 Subject: [PATCH 15/38] Fix: Keep all lines under 90 char (and aim for 80 char) With the exception of lists & code --- README.md | 7 +++-- community/README.md | 12 ++++---- community/asking-questions.md | 20 ++++++------- community/sharing.md | 55 ++++++++++++++++++++++------------- 4 files changed, 55 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index a8a944d..1729062 100644 --- a/README.md +++ b/README.md @@ -19,5 +19,8 @@ Vivaldi, make sure that you have all modifications disabled.** with it?* - Community - - [Sharing Mods](community/sharing.md) - *I've got a cool mod, how can I share it and make it easy for others to use?* - - [Asking Questions](community/asking-questions.md) - *I need some help, where and how should I ask?* + - [Sharing Mods](community/sharing.md) - *I've got a cool mod, how can I share it + and make it easy for others to use?* + + - [Asking Questions](community/asking-questions.md) - *I need some help, + where and how should I ask?* diff --git a/community/README.md b/community/README.md index 0cc784c..9b39465 100644 --- a/community/README.md +++ b/community/README.md @@ -1,9 +1,9 @@ # Using the Forum - The [modding forum](https://forum.vivaldi.net/category/52/modifications) - will be extremely helpful to learning how to mod and getting mods from others. - You will need a [vivaldi account](https://login.vivaldi.net) to post there. +The [modding forum](https://forum.vivaldi.net/category/52/modifications) +will be extremely helpful to learning how to mod and getting mods from others. +You will need a [vivaldi account](https://login.vivaldi.net) to post there. - Github/Gitlab will also be good tools for working on, managing, and sharing your mods, - and will allow you to comment, contribute to, and raise issues on other community member's repositories, - so you could sign up for an account there. +Github/Gitlab will also be good tools for working on, managing, and sharing your mods, +and will allow you to comment, contribute to, and raise issues on other community +member's repositories, so you could sign up for an account there. diff --git a/community/asking-questions.md b/community/asking-questions.md index ef8b27d..75d1310 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -2,9 +2,9 @@ Author(s): code3z (@code3 on the forum) - The [modding forum](https://forum.vivaldi.net/category/52/modifications) - is also a great place to ask questions about modding. Before asking, search the - forum and the internet to check if there is not already a good answer. +The [modding forum](https://forum.vivaldi.net/category/52/modifications) +is also a great place to ask questions about modding. Before asking, search the +forum and the internet to check if there is not already a good answer. When asking a question, keep a few simple things in mind: - Use a topic title that is descriptive @@ -15,11 +15,11 @@ When asking a question, keep a few simple things in mind: ## Asking For mods - You can use the forum to ask someone to make a mod for you. - But remember that it is a big favor: if they wanted this mod themselves, - they would have almost certainly made it. - So be patient, describe what you're looking for clearly, and realize that you may not get an answer at all - (especially if what you're asking is hard to do). +You can use the forum to ask someone to make a mod for you. +But remember that it is a big favor: if they wanted this mod themselves, +they would have almost certainly made it. So be patient, describe what you're looking for +clearly, and realize that you may not get an answer at all +(especially if what you're asking is hard to do). - If you think that what you're asking should be implemented in Vivaldi directly, - remember to make a feature request for it in the correct section of the forum. +If you think that what you're asking should be implemented in Vivaldi directly, +remember to make a feature request for it in the correct section of the forum. diff --git a/community/sharing.md b/community/sharing.md index d473e55..df55a40 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -1,20 +1,21 @@ # Sharing your Mods Author(s): code3z (@code3 on the forum) - Once you've created a mod that you're proud of, the next step is to share it. - Sharing will be a big help to other people. You can also get feedback and help from the community. - But it may also mean you have to respond to bugs in your code and help other people use your code. +Once you've created a mod that you're proud of, the next step is to share it. +Sharing will be a big help to other people. You can also get feedback and help from +the community. But it may also mean you have to respond to bugs in your code +and help other people use your code. ## Managing and Sharing Mods using Git You can use hosted Git repos such as GitHub and Gitlab to upload, -manage, share, and collaborate on mods. -See the Managing Mods section of this guide for more information on Git. +manage, share, and collaborate on mods. See the Managing Mods section of this +guide for more information on Git. ## Code headers - Putting a comment at the top of your code helps people understand it, - use it, and remember where it came from. Consider using this template: +Putting a comment at the top of your code helps people understand it, +use it, and remember where it came from. Consider using this template: ```Javascript OR CSS /** @@ -32,46 +33,58 @@ See the Managing Mods section of this guide for more information on Git. ### Versioning Your Mods - Instead of tracking each edit to your mod as a separate version, it's - easier and sometimes more helpful to include the latest version of - Vivaldi that it was tested in. Along with the last update time, this will - let you and others know how up-to-date the mod is. +Instead of tracking each edit to your mod as a separate version, it's +easier and sometimes more helpful to include the latest version of Vivaldi that +it was tested in. Along with the last update time, this will let you and others +know how up-to-date the mod is. - Because both the forum and Git keep track of posting times, it's not necessary - to include the last update time in the code header (but you can if you - want). +Because both the forum and Git keep track of posting times, it's not necessary +to include the last update time in the code header (but you can if you want). If you do want to version your mods, it would look like this: ``` * Version: 2.1 for Vivaldi 3.9.2289.3 ``` -If you want to keep it simple and use the last Vivaldi version, it would look like this (see the header template above): +If you want to keep it simple and use the last Vivaldi version, it would look +like this (see the header template above): + ``` * Version: Vivaldi version 3.9.2289.3 ``` ## Tagging Forum Posts -Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others that make sense: +Tagging your mods helps others find them. Use the forum tagging feature to +insert the following tags, in addition to any others that make sense: + 1. [Mod] 2. [CSS] and/or [JS] 3. [Area] (what area of the UI does it affect?) -> If the tag doesn't exist the forum software will create it - but please don't make new tags on your own! Only use tags that are suggested from the drop-down. +> If the tag doesn't exist the forum software will create it - +but please don't make new tags on your own! +Only use tags that are suggested from the drop-down. ![Tagging Posts Screenshot](../assets/images/tagging-posts.png) ## Describing your mods -Now that you've added your code, titled your post, and tagged it, you need to write content! What you write is really up to you, but be sure to include what the mod does, how it will help people, and if it has any shortcomings or bugs or does not work with certain settings. +Now that you've added your code, titled your post, and tagged it, you need to write content! +What you write is really up to you, but be sure to include what the mod does, +how it will help people, and if it has any shortcomings or bugs or does not +work with certain settings. -You should also **include a screenshot**. If the mod does something that can only be shown through a screen recording, take a screen recording and upload it as a GIF. You can find some screen recording tools in the resources section of this guide. +You should also **include a screenshot**. If the mod does something that can only be shown +through a screen recording, take a screen recording and upload it as a GIF. You can find +some screen recording tools in the resources section of this guide. -Good job, I hope to see your mods soon 👍 +Good job, I hope to see your mods soon! 👍 ## Editing Posts -To edit a post and update the code, click the three-dot menu. Alternatively, if using Git or cloud storage, just link to the file in the Git repository and don't worry about updating your post each time. +To edit a post and update the code, click the three-dot menu. Alternatively, if using +Git or cloud storage, just link to the file in the Git repository and don't worry about +updating your post each time. ![Editing Post Screenshot](../assets/images/editing-posts.png) From acbce6d724bf601908e40877dce90903b2ae813d Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Wed, 2 Jun 2021 17:28:34 -0400 Subject: [PATCH 16/38] Fix: Correct a few lines --- community/sharing.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/community/sharing.md b/community/sharing.md index df55a40..800edb3 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -70,14 +70,14 @@ Only use tags that are suggested from the drop-down. ## Describing your mods -Now that you've added your code, titled your post, and tagged it, you need to write content! -What you write is really up to you, but be sure to include what the mod does, -how it will help people, and if it has any shortcomings or bugs or does not -work with certain settings. - -You should also **include a screenshot**. If the mod does something that can only be shown -through a screen recording, take a screen recording and upload it as a GIF. You can find -some screen recording tools in the resources section of this guide. +Now that you've added your code, titled your post, and tagged it, +you need to write content! What you write is really up to you, but be sure to +include what the mod does, how it will help people, and if it has any shortcomings +or bugs or if it does not work with certain settings. + +You should also **include a screenshot**. If the mod does something that can only be +shown through a screen recording, take a screen recording and upload it as a GIF. +You can find some screen recording tools in the resources section of this guide. Good job, I hope to see your mods soon! 👍 From 412c597fe56d14198562f1900cee963f8a124849 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Thu, 3 Jun 2021 16:32:02 -0400 Subject: [PATCH 17/38] Move: assets/images -> assets/screenshots --- assets/{images => screenshots}/editing-posts.png | Bin assets/{images => screenshots}/tagging-posts.png | Bin community/sharing.md | 4 ++-- 3 files changed, 2 insertions(+), 2 deletions(-) rename assets/{images => screenshots}/editing-posts.png (100%) rename assets/{images => screenshots}/tagging-posts.png (100%) diff --git a/assets/images/editing-posts.png b/assets/screenshots/editing-posts.png similarity index 100% rename from assets/images/editing-posts.png rename to assets/screenshots/editing-posts.png diff --git a/assets/images/tagging-posts.png b/assets/screenshots/tagging-posts.png similarity index 100% rename from assets/images/tagging-posts.png rename to assets/screenshots/tagging-posts.png diff --git a/community/sharing.md b/community/sharing.md index 800edb3..29f2d21 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -66,7 +66,7 @@ insert the following tags, in addition to any others that make sense: but please don't make new tags on your own! Only use tags that are suggested from the drop-down. -![Tagging Posts Screenshot](../assets/images/tagging-posts.png) +![Tagging Posts Screenshot](../assets/screenshots/tagging-posts.png) ## Describing your mods @@ -87,4 +87,4 @@ To edit a post and update the code, click the three-dot menu. Alternatively, if Git or cloud storage, just link to the file in the Git repository and don't worry about updating your post each time. -![Editing Post Screenshot](../assets/images/editing-posts.png) +![Editing Post Screenshot](../assets/screenshots/editing-posts.png) From ec68d0e99a7e49cced9b1a2f80beb1f6c9c7b62a Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Thu, 3 Jun 2021 16:39:11 -0400 Subject: [PATCH 18/38] Even better line spacing! --- community/README.md | 6 +++--- community/asking-questions.md | 4 ++-- community/sharing.md | 26 +++++++++++++------------- 3 files changed, 18 insertions(+), 18 deletions(-) diff --git a/community/README.md b/community/README.md index 9b39465..467822a 100644 --- a/community/README.md +++ b/community/README.md @@ -4,6 +4,6 @@ The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be extremely helpful to learning how to mod and getting mods from others. You will need a [vivaldi account](https://login.vivaldi.net) to post there. -Github/Gitlab will also be good tools for working on, managing, and sharing your mods, -and will allow you to comment, contribute to, and raise issues on other community -member's repositories, so you could sign up for an account there. +Github/Gitlab will also be good tools for working on, managing, and sharing your +mods, and will allow you to comment, contribute to, and raise issues on other +community member's repositories, so you could sign up for an account there. diff --git a/community/asking-questions.md b/community/asking-questions.md index 75d1310..80cab29 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -17,8 +17,8 @@ When asking a question, keep a few simple things in mind: You can use the forum to ask someone to make a mod for you. But remember that it is a big favor: if they wanted this mod themselves, -they would have almost certainly made it. So be patient, describe what you're looking for -clearly, and realize that you may not get an answer at all +they would have almost certainly made it. So be patient, describe what you're +looking for clearly, and realize that you may not get an answer at all (especially if what you're asking is hard to do). If you think that what you're asking should be implemented in Vivaldi directly, diff --git a/community/sharing.md b/community/sharing.md index 29f2d21..cfbf269 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -2,15 +2,15 @@ Author(s): code3z (@code3 on the forum) Once you've created a mod that you're proud of, the next step is to share it. -Sharing will be a big help to other people. You can also get feedback and help from -the community. But it may also mean you have to respond to bugs in your code -and help other people use your code. +Sharing will be a big help to other people. You can also get feedback and help +from the community. But it may also mean you have to respond to bugs in your +code and help other people use your code. ## Managing and Sharing Mods using Git -You can use hosted Git repos such as GitHub and Gitlab to upload, -manage, share, and collaborate on mods. See the Managing Mods section of this -guide for more information on Git. +You can use hosted Git repos such as GitHub and Gitlab to upload, manage, share, +and collaborate on mods. See the Managing Mods section of this guide for more +information on Git. ## Code headers @@ -72,19 +72,19 @@ Only use tags that are suggested from the drop-down. Now that you've added your code, titled your post, and tagged it, you need to write content! What you write is really up to you, but be sure to -include what the mod does, how it will help people, and if it has any shortcomings -or bugs or if it does not work with certain settings. +include what the mod does, how it will help people, and if it has any +shortcomings or bugs or if it does not work with certain settings. -You should also **include a screenshot**. If the mod does something that can only be -shown through a screen recording, take a screen recording and upload it as a GIF. +You should also **include a screenshot**. If the mod does something that can only +be shown through a screen recording, take a screen recording and upload it as a GIF. You can find some screen recording tools in the resources section of this guide. Good job, I hope to see your mods soon! 👍 ## Editing Posts -To edit a post and update the code, click the three-dot menu. Alternatively, if using -Git or cloud storage, just link to the file in the Git repository and don't worry about -updating your post each time. +To edit a post and update the code, click the three-dot menu. Alternatively, if +using Git or cloud storage, just link to the file in the Git repository and +don't worry about updating your post each time. ![Editing Post Screenshot](../assets/screenshots/editing-posts.png) From f71214296a2dde157047dbae058a701e8855c1af Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:20:09 +0100 Subject: [PATCH 19/38] Spacing Update community/sharing.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index cfbf269..c31ea02 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -62,7 +62,7 @@ insert the following tags, in addition to any others that make sense: 2. [CSS] and/or [JS] 3. [Area] (what area of the UI does it affect?) -> If the tag doesn't exist the forum software will create it - +If the tag doesn't exist, the forum software will create it— but please don't make new tags on your own! Only use tags that are suggested from the drop-down. From f580909c4438d7b021cc88e947bf455cc45016c3 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:20:40 +0100 Subject: [PATCH 20/38] =?UTF-8?q?=E2=80=9CCloud=20Storage=E2=80=9D=20Updat?= =?UTF-8?q?e=20community/sharing.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index c31ea02..3a4c18f 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -84,7 +84,7 @@ Good job, I hope to see your mods soon! 👍 ## Editing Posts To edit a post and update the code, click the three-dot menu. Alternatively, if -using Git or cloud storage, just link to the file in the Git repository and +using Git or cloud storage, just link to the file and don't worry about updating your post each time. ![Editing Post Screenshot](../assets/screenshots/editing-posts.png) From 8410062c3e202e52c9e5ef9112834450de314da1 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:21:41 +0100 Subject: [PATCH 21/38] Capitalization Update community/asking-questions.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/asking-questions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index 80cab29..f20426d 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -13,7 +13,7 @@ When asking a question, keep a few simple things in mind: - Share any ways you thought you might fix the problem or things that didn't work - Don't add the "mod" tag to your post - save that for when you actually publish a mod -## Asking For mods +## Asking for Mods You can use the forum to ask someone to make a mod for you. But remember that it is a big favor: if they wanted this mod themselves, From 5293ec5faddcb4af0c2076188b75e9c2470949f8 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:22:53 +0100 Subject: [PATCH 22/38] May -> Will Update community/sharing.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index 3a4c18f..cb118e3 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -3,7 +3,7 @@ Author(s): code3z (@code3 on the forum) Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help -from the community. But it may also mean you have to respond to bugs in your +from the community. But it will also mean you have to respond to bugs in your code and help other people use your code. ## Managing and Sharing Mods using Git From bf39065ac04d7b24d45a3304d51a2cfd6868b165 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:27:09 +0100 Subject: [PATCH 23/38] Remove three dashes Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 1 - 1 file changed, 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index cb118e3..6dec161 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -21,7 +21,6 @@ use it, and remember where it came from. Consider using this template: /** * <TITLE> * https://forum.vivaldi.net/topic/<topic> - - - - * Description: <description> * <If your description is long, put the second part here> * Filename: <filename> From 574c9982f700229c8cb870de5f45d827af7a029a Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:29:57 +0100 Subject: [PATCH 24/38] Versioning Wording Update community/sharing.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index 6dec161..7af9299 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -32,7 +32,7 @@ use it, and remember where it came from. Consider using this template: ### Versioning Your Mods -Instead of tracking each edit to your mod as a separate version, it's +Instead of versioning your mods separately, it’s easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along with the last update time, this will let you and others know how up-to-date the mod is. From 46a1d7729f140a21eb26b8b17333dd879544f40d Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:31:17 +0100 Subject: [PATCH 25/38] Less Verbose Update community/sharing.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index 7af9299..9e1c2f7 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -40,7 +40,7 @@ know how up-to-date the mod is. Because both the forum and Git keep track of posting times, it's not necessary to include the last update time in the code header (but you can if you want). -If you do want to version your mods, it would look like this: +If you do want to version your mods, please include the Vivaldi version as well. ``` * Version: 2.1 for Vivaldi 3.9.2289.3 ``` From 17002346568990dbe650da680edfb272ebb7f6a4 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:50:11 +0100 Subject: [PATCH 26/38] Update community/asking-questions.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/asking-questions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index f20426d..293c488 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -10,7 +10,7 @@ When asking a question, keep a few simple things in mind: - Use a topic title that is descriptive - Be polite and don't use ALL CAPS - If you are asking questions about a certain piece of code, share that code - - Share any ways you thought you might fix the problem or things that didn't work + - Share any ways you thought might fix the problem even if they didn’t work - Don't add the "mod" tag to your post - save that for when you actually publish a mod ## Asking for Mods From 13d9bc54e8305320952ffff919336bba75fc7f11 Mon Sep 17 00:00:00 2001 From: code3z <77302900+code3z@users.noreply.github.com> Date: Sat, 5 Jun 2021 11:50:55 +0100 Subject: [PATCH 27/38] Update community/sharing.md Co-authored-by: tiosgz <53824308+tiosgz@users.noreply.github.com> --- community/sharing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/sharing.md b/community/sharing.md index 9e1c2f7..1e09cc1 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -15,7 +15,7 @@ information on Git. ## Code headers Putting a comment at the top of your code helps people understand it, -use it, and remember where it came from. Consider using this template: +use it, and remember where it came from. Consider using a header like this: ```Javascript OR CSS /** From 06e14afc9afb0eaedfbe5c4da4ba794944582d4b Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sat, 5 Jun 2021 19:44:13 -0400 Subject: [PATCH 28/38] Add non-conflicting README --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ade13d3 --- /dev/null +++ b/README.md @@ -0,0 +1,20 @@ +# Modding Vivaldi + +This repository will eventually contain some guides to help you with modding the +Vivaldi browser. + +**Please note that modifications are not officially supported by Vivaldi. There +is no guarantee that they will work, they may even break Vivaldi. Vivaldi have +no obligation to support modifications or keep the browser backwards-compatible +for them.** + +**When a modification stops working, do not blame Vivaldi and instead ask the +author of the modification politely if they can fix it. When reporting bugs to +Vivaldi, make sure that you have all modifications disabled.** + +## Contents + +- Basics + - [Installation](using-mods/installation.md)—*I’ve got some code, what to do + with it?* +- Advanced From 5483857be4930cd99c1399a23ddb112cbf0f7fc1 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sat, 5 Jun 2021 19:54:02 -0400 Subject: [PATCH 29/38] Minor changes --- README.md | 4 ++++ community/README.md | 2 +- community/sharing.md | 7 ++++--- 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ade13d3..34a88e1 100644 --- a/README.md +++ b/README.md @@ -18,3 +18,7 @@ Vivaldi, make sure that you have all modifications disabled.** - [Installation](using-mods/installation.md)—*I’ve got some code, what to do with it?* - Advanced + +- Community + - [Asking Questions](community/asking-questions.md)-*I've got a question, where should I ask it?* + - [Sharing Mods](community/sharing.md)-*I made some code, where and how should I share it?* diff --git a/community/README.md b/community/README.md index 467822a..83ccf39 100644 --- a/community/README.md +++ b/community/README.md @@ -1,4 +1,4 @@ -# Using the Forum +# Community The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be extremely helpful to learning how to mod and getting mods from others. diff --git a/community/sharing.md b/community/sharing.md index 1e09cc1..69f5d0c 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -51,14 +51,15 @@ like this (see the header template above): ``` * Version: Vivaldi version 3.9.2289.3 ``` +## Posting Mods to the Forum -## Tagging Forum Posts +### Tagging Forum Posts Tagging your mods helps others find them. Use the forum tagging feature to insert the following tags, in addition to any others that make sense: - 1. [Mod] - 2. [CSS] and/or [JS] + 1. [Modding] + 2. [CSS] and/or [JavaScript] 3. [Area] (what area of the UI does it affect?) If the tag doesn't exist, the forum software will create it— From 8f5420cf72629f120155669b1037d5dd1870275e Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sat, 5 Jun 2021 19:57:33 -0400 Subject: [PATCH 30/38] Long Lines --- community/asking-questions.md | 3 ++- community/sharing.md | 7 ++++--- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index 293c488..aa5c658 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -11,7 +11,8 @@ When asking a question, keep a few simple things in mind: - Be polite and don't use ALL CAPS - If you are asking questions about a certain piece of code, share that code - Share any ways you thought might fix the problem even if they didn’t work - - Don't add the "mod" tag to your post - save that for when you actually publish a mod + - Don't add the "mod" tag to your post - save that for when you actually + publish a mod ## Asking for Mods diff --git a/community/sharing.md b/community/sharing.md index 69f5d0c..b14019f 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -75,9 +75,10 @@ you need to write content! What you write is really up to you, but be sure to include what the mod does, how it will help people, and if it has any shortcomings or bugs or if it does not work with certain settings. -You should also **include a screenshot**. If the mod does something that can only -be shown through a screen recording, take a screen recording and upload it as a GIF. -You can find some screen recording tools in the resources section of this guide. +You should also **include a screenshot**. If the mod does something that can +only be shown through a screen recording, take a screen recording and upload +it as a GIF. You can find some screen recording tools in the resources section +of this guide. Good job, I hope to see your mods soon! 👍 From 0d6317d519ee2f735689f48327eb7d7118b41210 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 6 Jun 2021 12:05:47 -0400 Subject: [PATCH 31/38] More minor Changes --- community/asking-questions.md | 12 ++++++------ community/sharing.md | 31 ++++++++++++++----------------- 2 files changed, 20 insertions(+), 23 deletions(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index aa5c658..346d7c1 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -3,7 +3,7 @@ Author(s): code3z (@code3 on the forum) The [modding forum](https://forum.vivaldi.net/category/52/modifications) -is also a great place to ask questions about modding. Before asking, search the +is a great place to ask questions about modding. Before asking, search the forum and the internet to check if there is not already a good answer. When asking a question, keep a few simple things in mind: @@ -16,11 +16,11 @@ When asking a question, keep a few simple things in mind: ## Asking for Mods -You can use the forum to ask someone to make a mod for you. -But remember that it is a big favor: if they wanted this mod themselves, -they would have almost certainly made it. So be patient, describe what you're -looking for clearly, and realize that you may not get an answer at all -(especially if what you're asking is hard to do). +You can use the forum to ask someone to make a mod for you. But remember that +it is a big favor: if they wanted this mod themselves, they would have almost +certainly made it. So be patient, describe what you're looking for clearly, and +realize that you may not get an answer at all (especially if what you're asking +is hard to do). If you think that what you're asking should be implemented in Vivaldi directly, remember to make a feature request for it in the correct section of the forum. diff --git a/community/sharing.md b/community/sharing.md index b14019f..b9cbfb7 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -8,37 +8,34 @@ code and help other people use your code. ## Managing and Sharing Mods using Git -You can use hosted Git repos such as GitHub and Gitlab to upload, manage, share, -and collaborate on mods. See the Managing Mods section of this guide for more -information on Git. +You can use hosted Git repositories such as GitHub and GitLab to upload, manage, +share, and collaborate on mods. See the Managing Mods section of this guide +for more information on Git. ## Code headers Putting a comment at the top of your code helps people understand it, use it, and remember where it came from. Consider using a header like this: -```Javascript OR CSS +```CSS /** * <TITLE> * https://forum.vivaldi.net/topic/<topic> * Description: <description> - * <If your description is long, put the second part here> - * Filename: <filename> - * Platform: <Linux/Mac/Windows/All> - * Version: Vivaldi version <version> - * Author(s): <Here you can add your forum username, and username for github or any relevant app (also add any other contributors here)> + * <If your description is long, put the second part here> + * Filename: <filename> + * Platform: <Linux/Mac/Windows/All> + * Version: Vivaldi version <version> + * Author(s): <Here you can add your forum username, and username for github or any relevant app (also add any other contributors here)> **/ ``` ### Versioning Your Mods -Instead of versioning your mods separately, it’s -easier and sometimes more helpful to include the latest version of Vivaldi that -it was tested in. Along with the last update time, this will let you and others -know how up-to-date the mod is. - -Because both the forum and Git keep track of posting times, it's not necessary -to include the last update time in the code header (but you can if you want). +Instead of versioning your mods separately, it’s easier and sometimes more +helpful to include the latest version of Vivaldi that it was tested in. Along +with the last update time and version history (shown by Git or the forum), +this will let you and others know how up-to-date the mod is. If you do want to version your mods, please include the Vivaldi version as well. ``` @@ -77,7 +74,7 @@ shortcomings or bugs or if it does not work with certain settings. You should also **include a screenshot**. If the mod does something that can only be shown through a screen recording, take a screen recording and upload -it as a GIF. You can find some screen recording tools in the resources section +it as a GIF. You can find some screen recording tools in the resources section of this guide. Good job, I hope to see your mods soon! 👍 From 2de92bdb92b0eac70698fd333d1c12139bc6d048 Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 6 Jun 2021 12:21:28 -0400 Subject: [PATCH 32/38] More minor changes, including images --- .../editing-posts.png | Bin assets/forum-screenshots/post-as-question.png | Bin 0 -> 4967 bytes .../tagging-posts.png | Bin community/asking-questions.md | 12 ++++++++++-- community/sharing.md | 4 ++-- 5 files changed, 12 insertions(+), 4 deletions(-) rename assets/{screenshots => forum-screenshots}/editing-posts.png (100%) create mode 100644 assets/forum-screenshots/post-as-question.png rename assets/{screenshots => forum-screenshots}/tagging-posts.png (100%) diff --git a/assets/screenshots/editing-posts.png b/assets/forum-screenshots/editing-posts.png similarity index 100% rename from assets/screenshots/editing-posts.png rename to assets/forum-screenshots/editing-posts.png diff --git a/assets/forum-screenshots/post-as-question.png b/assets/forum-screenshots/post-as-question.png new file mode 100644 index 0000000000000000000000000000000000000000..b02d37ef843df11f523112aadcd0aa3d907a3e6e GIT binary patch literal 4967 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 literal 0 HcmV?d00001 diff --git a/assets/screenshots/tagging-posts.png b/assets/forum-screenshots/tagging-posts.png similarity index 100% rename from assets/screenshots/tagging-posts.png rename to assets/forum-screenshots/tagging-posts.png diff --git a/community/asking-questions.md b/community/asking-questions.md index 346d7c1..f660215 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -11,7 +11,7 @@ When asking a question, keep a few simple things in mind: - Be polite and don't use ALL CAPS - If you are asking questions about a certain piece of code, share that code - Share any ways you thought might fix the problem even if they didn’t work - - Don't add the "mod" tag to your post - save that for when you actually + - Don't add the "mod" or "modding" tags to your post - save that for when you actually publish a mod ## Asking for Mods @@ -23,4 +23,12 @@ realize that you may not get an answer at all (especially if what you're asking is hard to do). If you think that what you're asking should be implemented in Vivaldi directly, -remember to make a feature request for it in the correct section of the forum. +remember to make a feature request for it in the [correct section of the forum](https://forum.vivaldi.net/category/113/feature-requests). + + +## Posting As A Question + +Please use the drop-down menu next to the "Submit" button to mark your post +as a question, like this: + +![](../assets/forum-screenshots/post-as-question.png) diff --git a/community/sharing.md b/community/sharing.md index b9cbfb7..d7d675f 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -63,7 +63,7 @@ If the tag doesn't exist, the forum software will create it— but please don't make new tags on your own! Only use tags that are suggested from the drop-down. -![Tagging Posts Screenshot](../assets/screenshots/tagging-posts.png) +![Tagging Posts Screenshot](../assets/forum-screenshots/tagging-posts.png) ## Describing your mods @@ -85,4 +85,4 @@ To edit a post and update the code, click the three-dot menu. Alternatively, if using Git or cloud storage, just link to the file and don't worry about updating your post each time. -![Editing Post Screenshot](../assets/screenshots/editing-posts.png) +![Editing Post Screenshot](../assets/forum-screenshots/editing-posts.png) From efabe8d8ffc958f71f8b926faf620d9961488ccb Mon Sep 17 00:00:00 2001 From: code3z <code3@vivaldi.net> Date: Sun, 6 Jun 2021 12:25:31 -0400 Subject: [PATCH 33/38] Better README --- community/README.md | 8 +------- community/sharing.md | 6 ++++++ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/community/README.md b/community/README.md index 83ccf39..6e69ae7 100644 --- a/community/README.md +++ b/community/README.md @@ -1,9 +1,3 @@ # Community -The [modding forum](https://forum.vivaldi.net/category/52/modifications) -will be extremely helpful to learning how to mod and getting mods from others. -You will need a [vivaldi account](https://login.vivaldi.net) to post there. - -Github/Gitlab will also be good tools for working on, managing, and sharing your -mods, and will allow you to comment, contribute to, and raise issues on other -community member's repositories, so you could sign up for an account there. +This folder contains information about the Vivaldi community, and does not contain code. You can raise an issue, use the edit button, or open a pull request to contribute. diff --git a/community/sharing.md b/community/sharing.md index d7d675f..7ee19ca 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -1,6 +1,12 @@ # Sharing your Mods Author(s): code3z (@code3 on the forum) +The [modding forum](https://forum.vivaldi.net/category/52/modifications) +will be extremely helpful to learning how to mod and getting mods from others. +You will need a [vivaldi account](https://login.vivaldi.net) to post there. You might also want a GitHub and GitLab account as another way to share your mods. + +--- + Once you've created a mod that you're proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help from the community. But it will also mean you have to respond to bugs in your From f66d57cbde7d375a77e5eaf08fcd33067fedaa72 Mon Sep 17 00:00:00 2001 From: tiosgz <alamica@protonmail.com> Date: Thu, 10 Jun 2021 15:35:52 +0000 Subject: [PATCH 34/38] Fixes & high-priority suggestions --- community/asking-questions.md | 31 +++++++-------- community/sharing.md | 72 ++++++++++++++++++----------------- 2 files changed, 54 insertions(+), 49 deletions(-) diff --git a/community/asking-questions.md b/community/asking-questions.md index f660215..9931ba2 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -1,34 +1,35 @@ # Asking Questions on the Forum -Author(s): code3z (@code3 on the forum) +Author(s): code3z (code3) The [modding forum](https://forum.vivaldi.net/category/52/modifications) is a great place to ask questions about modding. Before asking, search the forum and the internet to check if there is not already a good answer. When asking a question, keep a few simple things in mind: - - Use a topic title that is descriptive - - Be polite and don't use ALL CAPS - - If you are asking questions about a certain piece of code, share that code - - Share any ways you thought might fix the problem even if they didn’t work - - Don't add the "mod" or "modding" tags to your post - save that for when you actually - publish a mod + +- Use a topic title that is descriptive +- Be polite and don’t use ALL CAPS +- If you are asking questions about a certain piece of code, share that code +- Share any ways you thought might fix the problem even if they didn’t work +- Don’t add the “mod” or “modding” tags to your post—save that for when you + actually publish a mod ## Asking for Mods -You can use the forum to ask someone to make a mod for you. But remember that -it is a big favor: if they wanted this mod themselves, they would have almost -certainly made it. So be patient, describe what you're looking for clearly, and -realize that you may not get an answer at all (especially if what you're asking +You can use the forum to ask someone to make a mod for you. But remember that it +is a big favor: if they wanted this mod themselves, they would have almost +certainly made it. So be patient, describe what you’re looking for clearly, and +realize that you may not get an answer at all (especially if what you’re asking is hard to do). -If you think that what you're asking should be implemented in Vivaldi directly, -remember to make a feature request for it in the [correct section of the forum](https://forum.vivaldi.net/category/113/feature-requests). - +If you think that what you’re asking for should be implemented in Vivaldi +directly, remember to make a feature request for it in the [correct section of +the forum](https://forum.vivaldi.net/category/113/feature-requests). ## Posting As A Question -Please use the drop-down menu next to the "Submit" button to mark your post +Please use the drop-down menu next to the “Submit” button to mark your post as a question, like this: ![](../assets/forum-screenshots/post-as-question.png) diff --git a/community/sharing.md b/community/sharing.md index 7ee19ca..ef15fbb 100644 --- a/community/sharing.md +++ b/community/sharing.md @@ -1,38 +1,40 @@ # Sharing your Mods -Author(s): code3z (@code3 on the forum) -The [modding forum](https://forum.vivaldi.net/category/52/modifications) -will be extremely helpful to learning how to mod and getting mods from others. -You will need a [vivaldi account](https://login.vivaldi.net) to post there. You might also want a GitHub and GitLab account as another way to share your mods. +Author(s): code3z (code3) + +The [modding forum](https://forum.vivaldi.net/category/52/modifications) will be +extremely helpful for learning how to mod and getting mods from others. You will +need a [Vivaldi account](https://login.vivaldi.net) to post there. You might +also want a GitHub and/or GitLab account as another way to share your mods. --- -Once you've created a mod that you're proud of, the next step is to share it. +Once you’ve created a mod that you’re proud of, the next step is to share it. Sharing will be a big help to other people. You can also get feedback and help from the community. But it will also mean you have to respond to bugs in your code and help other people use your code. ## Managing and Sharing Mods using Git -You can use hosted Git repositories such as GitHub and GitLab to upload, manage, -share, and collaborate on mods. See the Managing Mods section of this guide -for more information on Git. +You can use Git repository hosting services such as GitHub and GitLab to upload, +manage, share, and collaborate on mods. See the Managing Mods guide for more +information on Git. -## Code headers +## Code Headers -Putting a comment at the top of your code helps people understand it, -use it, and remember where it came from. Consider using a header like this: +Putting a comment at the top of your code helps people understand it, use it, +and remember where it came from. Consider using a header like this: -```CSS +```css /** - * <TITLE> + * <title> * https://forum.vivaldi.net/topic/<topic> - * Description: <description> - * <If your description is long, put the second part here> - * Filename: <filename> - * Platform: <Linux/Mac/Windows/All> - * Version: Vivaldi version <version> - * Author(s): <Here you can add your forum username, and username for github or any relevant app (also add any other contributors here)> + * Description: <description> + * <if your description is long, continue it here> + * Filename: <filename> + * Platform: <All/Linux/Mac/Windows> + * Version: Vivaldi version <version> + * Author(s): <forum/GitHub/GitLab username, contributors> **/ ``` @@ -40,20 +42,22 @@ use it, and remember where it came from. Consider using a header like this: Instead of versioning your mods separately, it’s easier and sometimes more helpful to include the latest version of Vivaldi that it was tested in. Along -with the last update time and version history (shown by Git or the forum), -this will let you and others know how up-to-date the mod is. +with the last update time and version history (shown by Git or the forum), this +will let you and others know how up-to-date the mod is. If you do want to version your mods, please include the Vivaldi version as well. + ``` - * Version: 2.1 for Vivaldi 3.9.2289.3 + * Version: 2.1 for Vivaldi 3.9.2289.3 ``` If you want to keep it simple and use the last Vivaldi version, it would look like this (see the header template above): ``` - * Version: Vivaldi version 3.9.2289.3 + * Version: Vivaldi version 3.9.2289.3 ``` + ## Posting Mods to the Forum ### Tagging Forum Posts @@ -63,20 +67,20 @@ insert the following tags, in addition to any others that make sense: 1. [Modding] 2. [CSS] and/or [JavaScript] - 3. [Area] (what area of the UI does it affect?) + 3. [Area]—what area of the UI does it affect? -If the tag doesn't exist, the forum software will create it— -but please don't make new tags on your own! -Only use tags that are suggested from the drop-down. +If the tag doesn’t exist, the forum software will create it—but please **don’t +make new tags** on your own! Only use tags that are suggested from the +drop-down. ![Tagging Posts Screenshot](../assets/forum-screenshots/tagging-posts.png) -## Describing your mods +## Describing Your Mods -Now that you've added your code, titled your post, and tagged it, -you need to write content! What you write is really up to you, but be sure to -include what the mod does, how it will help people, and if it has any -shortcomings or bugs or if it does not work with certain settings. +Now that you’ve added your code, titled your post, and tagged it, you need to +write content! What you write is really up to you, but be sure to include what +the mod does, how it will help people, and if it has any shortcomings or bugs +or if it does not work with certain settings. You should also **include a screenshot**. If the mod does something that can only be shown through a screen recording, take a screen recording and upload @@ -88,7 +92,7 @@ Good job, I hope to see your mods soon! 👍 ## Editing Posts To edit a post and update the code, click the three-dot menu. Alternatively, if -using Git or cloud storage, just link to the file and -don't worry about updating your post each time. +using Git or cloud storage, just link to the file and don’t worry about +updating your post each time. ![Editing Post Screenshot](../assets/forum-screenshots/editing-posts.png) From d3b8daa7db6858608003bdef79e7d3d9a0e67d3d Mon Sep 17 00:00:00 2001 From: tiosgz <alamica@protonmail.com> Date: Thu, 10 Jun 2021 15:36:59 +0000 Subject: [PATCH 35/38] Suggestions --- community/README.md | 3 --- community/{sharing.md => sharing-mods.md} | 11 ----------- 2 files changed, 14 deletions(-) delete mode 100644 community/README.md rename community/{sharing.md => sharing-mods.md} (93%) diff --git a/community/README.md b/community/README.md deleted file mode 100644 index 6e69ae7..0000000 --- a/community/README.md +++ /dev/null @@ -1,3 +0,0 @@ -# Community - -This folder contains information about the Vivaldi community, and does not contain code. You can raise an issue, use the edit button, or open a pull request to contribute. diff --git a/community/sharing.md b/community/sharing-mods.md similarity index 93% rename from community/sharing.md rename to community/sharing-mods.md index ef15fbb..ddd166c 100644 --- a/community/sharing.md +++ b/community/sharing-mods.md @@ -47,17 +47,6 @@ will let you and others know how up-to-date the mod is. If you do want to version your mods, please include the Vivaldi version as well. -``` - * Version: 2.1 for Vivaldi 3.9.2289.3 -``` - -If you want to keep it simple and use the last Vivaldi version, it would look -like this (see the header template above): - -``` - * Version: Vivaldi version 3.9.2289.3 -``` - ## Posting Mods to the Forum ### Tagging Forum Posts From ce87d2c86495f29868d16f1f3fc1ec590a15d47b Mon Sep 17 00:00:00 2001 From: tiosgz <alamica@protonmail.com> Date: Thu, 10 Jun 2021 15:39:24 +0000 Subject: [PATCH 36/38] (don't) read me --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 34a88e1..d4be57c 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ Vivaldi, make sure that you have all modifications disabled.** - [Installation](using-mods/installation.md)—*I’ve got some code, what to do with it?* - Advanced - - Community - - [Asking Questions](community/asking-questions.md)-*I've got a question, where should I ask it?* - - [Sharing Mods](community/sharing.md)-*I made some code, where and how should I share it?* + - [Asking Questions](community/asking-questions.md)—*Where can I get help?* + - [Sharing Mods](community/sharing.md)—please do not keep your mods for + yourself! From ed2ee45ec77fb4606369748e257c7165ea2f9f18 Mon Sep 17 00:00:00 2001 From: tiosgz <alamica@protonmail.com> Date: Thu, 10 Jun 2021 15:45:02 +0000 Subject: [PATCH 37/38] Assets paths fix --- .../asking-questions}/post-as-question.png | Bin .../sharing-mods/edit-post.png} | Bin .../sharing-mods/tag-post.png} | Bin community/asking-questions.md | 2 +- community/sharing-mods.md | 4 ++-- 5 files changed, 3 insertions(+), 3 deletions(-) rename assets/{forum-screenshots => community/asking-questions}/post-as-question.png (100%) rename assets/{forum-screenshots/editing-posts.png => community/sharing-mods/edit-post.png} (100%) rename assets/{forum-screenshots/tagging-posts.png => community/sharing-mods/tag-post.png} (100%) diff --git a/assets/forum-screenshots/post-as-question.png b/assets/community/asking-questions/post-as-question.png similarity index 100% rename from assets/forum-screenshots/post-as-question.png rename to assets/community/asking-questions/post-as-question.png diff --git a/assets/forum-screenshots/editing-posts.png b/assets/community/sharing-mods/edit-post.png similarity index 100% rename from assets/forum-screenshots/editing-posts.png rename to assets/community/sharing-mods/edit-post.png diff --git a/assets/forum-screenshots/tagging-posts.png b/assets/community/sharing-mods/tag-post.png similarity index 100% rename from assets/forum-screenshots/tagging-posts.png rename to assets/community/sharing-mods/tag-post.png diff --git a/community/asking-questions.md b/community/asking-questions.md index 9931ba2..766f167 100644 --- a/community/asking-questions.md +++ b/community/asking-questions.md @@ -32,4 +32,4 @@ the forum](https://forum.vivaldi.net/category/113/feature-requests). Please use the drop-down menu next to the “Submit” button to mark your post as a question, like this: -![](../assets/forum-screenshots/post-as-question.png) +![](../assets/community/asking-questions/post-as-question.png) diff --git a/community/sharing-mods.md b/community/sharing-mods.md index ddd166c..c3a227e 100644 --- a/community/sharing-mods.md +++ b/community/sharing-mods.md @@ -62,7 +62,7 @@ If the tag doesn’t exist, the forum software will create it—but please **don make new tags** on your own! Only use tags that are suggested from the drop-down. -![Tagging Posts Screenshot](../assets/forum-screenshots/tagging-posts.png) +![Tagging Posts Screenshot](../assets/community/sharing-mods/tag-post.png) ## Describing Your Mods @@ -84,4 +84,4 @@ To edit a post and update the code, click the three-dot menu. Alternatively, if using Git or cloud storage, just link to the file and don’t worry about updating your post each time. -![Editing Post Screenshot](../assets/forum-screenshots/editing-posts.png) +![Editing Post Screenshot](../assets/community/sharing-mods/edit-post.png) From 5018df00303f1b0e0fe220046bf0c4c8a763fc2b Mon Sep 17 00:00:00 2001 From: tiosgz <alamica@protonmail.com> Date: Thu, 10 Jun 2021 15:50:26 +0000 Subject: [PATCH 38/38] (don't) read me again --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d4be57c..c0d82bf 100644 --- a/README.md +++ b/README.md @@ -20,5 +20,5 @@ Vivaldi, make sure that you have all modifications disabled.** - Advanced - Community - [Asking Questions](community/asking-questions.md)—*Where can I get help?* - - [Sharing Mods](community/sharing.md)—please do not keep your mods for + - [Sharing Mods](community/sharing-mods.md)—please do not keep your mods for yourself!