Update CODE OF CONDUCT, configuration files, and documentation

GioemaNocco · GioemaNocco · commit a45973cb6f86 · 2025-10-09T12:39:42.000+02:00
- Revised CODE OF CONDUCT for clarity and consistency.
- Updated pagination settings in config.toml to use [pagination] section.
- Added Italian language support in languages.toml with adjusted weights for German and Dutch.
- Changed copyright year in params.toml from 2024 to 2025.
- Improved formatting in authentication documentation for better readability.
- Upgraded Hugo version in package.json from 0.139.0 to 0.148.0.
- Added Italian localization file it.toml with initial content.
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -1,3 +1,3 @@
 # These are supported funding model platforms
 open_collective: genocs
-custom: ['https://www.buymeacoffee.com/genocs']
+custom: ["https://www.buymeacoffee.com/genocs"]
diff --git a/.github/ISSUE_TEMPLATE/bug-report---.md b/.github/ISSUE_TEMPLATE/bug-report---.md
@@ -1,10 +1,9 @@
 ---
 name: "Bug report \U0001F41E"
 about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
+title: ""
+labels: ""
+assignees: ""
 ---
 
 ## Description
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,4 +1,4 @@
 contact_links:
   - name: Question 🙋
     url: https://github.com/h-enk/doks/discussions/categories/q-a
-    about: Ask your question in Doks Discussions
+    about: Ask your question in Doks Discussions
diff --git a/.github/ISSUE_TEMPLATE/documenation-request.md b/.github/ISSUE_TEMPLATE/documenation-request.md
@@ -4,5 +4,4 @@ about: Suggest a new documentation / article for genocs.
 title: "[Documentation] "
 labels: documentation
 assignees: giovanninocco
-
 ---
diff --git a/.github/ISSUE_TEMPLATE/feature-request---.md b/.github/ISSUE_TEMPLATE/feature-request---.md
@@ -1,10 +1,9 @@
 ---
 name: "Feature request \U0001F680"
 about: Suggest an idea for Doks
-title: ''
-labels: ''
-assignees: ''
-
+title: ""
+labels: ""
+assignees: ""
 ---
 
 ## Summary
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -17,23 +17,23 @@ diverse, inclusive, and healthy community.
 Examples of behavior that contributes to a positive environment for our
 community include:
 
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
   and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
+- Focusing on what is best not just for us as individuals, but for the
   overall community
 
 Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery, and sexual attention or
+- The use of sexualized language or imagery, and sexual attention or
   advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
   address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 ## Enforcement Responsibilities
@@ -106,7 +106,7 @@ Violating these terms may lead to a permanent ban.
 ### 4. Permanent Ban
 
 **Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior,  harassment of an
+standards, including sustained inappropriate behavior, harassment of an
 individual, or aggression toward or disparagement of classes of individuals.
 
 **Consequence**: A permanent ban from any sort of public interaction within
diff --git a/config/_default/config.toml b/config/_default/config.toml
@@ -6,7 +6,8 @@ enableEmoji = true
 enableGitInfo = true
 enableRobotsTXT = true
 languageCode = "en-US"
-paginate = 7
+[pagination]
+pagerSize = 7
 rssLimit = 10
 googleAnalytics = "UA-32530775-1"
 
diff --git a/config/_default/languages.toml b/config/_default/languages.toml
@@ -5,17 +5,24 @@
   [en.params]
     languageISO = "EN"
 
+[it]
+  languageName = "Italian"
+  contentDir = "content/it"
+  weight = 15
+  [it.params]
+    languageISO = "IT"
+
 [de]
   languageName = "German"
   contentDir = "content/de"
-  weight = 15
+  weight = 20
   [de.params]
     languageISO = "DE"
 
 [nl]
   languageName = "Nederlands"
   contentDir = "content/nl"
-  weight = 20
+  weight = 25
   [nl.params]
     languageISO = "NL"
     titleAddition = "Modern documentatie-thema"
diff --git a/config/_default/params.toml b/config/_default/params.toml
@@ -64,7 +64,7 @@ smallLimit = "30"
 footer = "Developed & Maintained by <a href=\"https://www.genocs.com/\">Genocs</a>"
 
 # Feed
-copyRight = "Copyright (c) 2024 Genocs"
+copyRight = "Copyright (c) 2025 Genocs"
 
 # Alert
 alert = true
diff --git a/content/en/library/authentication/index.md b/content/en/library/authentication/index.md
@@ -1,5 +1,5 @@
 ---
-title : "Authentication - JWT"
+title: "Authentication - JWT"
 description: "Adds the integration with JWT using an available authentication middleware and system components to validate and grant the access tokens."
 lead: ""
 date: 2023-05-13T15:40:19+02:00
@@ -17,7 +17,7 @@ toc: true
 
 ## Installation
 
-``` bash
+```bash
 dotnet add package Genocs.Auth
 ```
 
@@ -44,7 +44,7 @@ There are three different ways you can to create the access tokens:
 
 Extend `IGenocsBuilder` with `AddJwt()` that will register the required services.
 
-``` cs
+```cs
 public static IGenocsBuilder RegisterGenocs(this IGenocsBuilder builder)
 {
     builder.AddJwt()
@@ -58,7 +58,7 @@ public static IGenocsBuilder RegisterGenocs(this IGenocsBuilder builder)
 
 Extend `IGenocsBuilder` with `AddPrivateKeyJwt()` that will register the required services.
 
-``` cs
+```cs
 public static IGenocsBuilder RegisterGenocs(this IGenocsBuilder builder)
 {
     builder.AddPrivateKeyJwt()
@@ -68,14 +68,13 @@ public static IGenocsBuilder RegisterGenocs(this IGenocsBuilder builder)
 }
 ```
 
-
 ## JWT authentication with OpenId provider
 
 OpenId official web page: [https://openid.net/](https://openid.net/)
 
 Extend `IGenocsBuilder` with `AddOpenIdJwt()` that will register the required services.
 
-``` cs
+```cs
 public static IGenocsBuilder RegisterGenocs(this IGenocsBuilder builder)
 {
     builder.AddOpenIdJwt()
@@ -86,7 +85,8 @@ public static IGenocsBuilder RegisterGenocs(this IGenocsBuilder builder)
 ```
 
 Add the use of the authentication middleware in the `ConfigureServices` method of the `Startup` class.
-``` cs
+
+```cs
 public static IGenocsBuilder UseGenocs(this IGenocsBuilder builder)
 {
     builder.UseOpenIdJwt()
@@ -97,30 +97,32 @@ public static IGenocsBuilder UseGenocs(this IGenocsBuilder builder)
 ```
 
 Build an authentication middleware that will validate the access tokens.
-``` cs
+
+```cs
 public static IApplicationBuilder UseFirebaseAuthentication(this IApplicationBuilder builder)
 {
     return builder.UseMiddleware<FirebaseAuthenticationMiddleware>();
 }
 ```
 
 Add the use of the authentication middleware in the `Configure` method of the `Startup` class.
-``` cs
+
+```cs
 app.UseFirebaseAuthentication();
 ```
 
 **NOTE**: Please, make sure that the `System.IdentityModel.Tokens.Jwt` package is NOT installed in the project. If it is, remove it from the project file.
 
-``` cs
+```cs
     <ItemGroup>
         <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="7.6.2" />
     </ItemGroup>
-``` cs
+```
 
 
 Then, invoke `UseAuthentication()` extension from `IApplicationBuilder`.
 
-``` cs
+```cs
 public static IApplicationBuilder UseGenocs(this IApplicationBuilder app)
 {
     app.UseAuthentication();
@@ -132,7 +134,7 @@ public static IApplicationBuilder UseGenocs(this IApplicationBuilder app)
 
 Creating the access tokens can be done by using `IJwtHandler` interface.
 
-``` c#
+```cs
 public class UserService
 {
     private readonly IJwtHandler _jwtHandler;
@@ -141,14 +143,14 @@ public class UserService
     {
         _jwtHandler = jwtHandler;
     }
-    
+
     public async Task<string> SignInAsync(string email, string password)
     {
         var user = ... //Fetch the user from a custom database
         ValidateCredentials(user, password); //Validate the credentials etc.
 
         //Generate the token with an optional role and other claims
-        var token = _jwtHandler.CreateToken(user.Id, user.Role, user.Claims); 
+        var token = _jwtHandler.CreateToken(user.Id, user.Role, user.Claims);
 
         return token.AccessToken;
     }
@@ -159,7 +161,7 @@ To blacklist and deactivate the access tokens, use `IAccessTokenService` and inv
 
 ## Options
 
-The default section name for the JWT settings is `jwt`. The following options are available: 
+The default section name for the JWT settings is `jwt`. The following options are available:
 
 - `enabled` - If true then the JWT authentication is enabled.
 - `allowAnonymousEndpoints` - If true then the JWT authentication is disabled for the endpoints with the AllowAnonymous attribute.
@@ -170,7 +172,7 @@ The default section name for the JWT settings is `jwt`. The following options ar
 - `validIssuer` - An issuer that can use the access tokens.
 - `authority` - The URL of the OpenId provider.
 - `audience` - An audience that can use the access tokens.
-- `challenge` - The challenge used to authenticate the user.    
+- `challenge` - The challenge used to authenticate the user.
 - `metadataAddress` - The URL of the OpenId provider metadata.
 - `saveToken` - If true then the token will be saved in the authentication properties.
 - `saveSigninToken` - If true then the token will be saved in the sign-in properties.
@@ -268,4 +270,4 @@ Default settings for some variable has bee overwritten with the following config
   "includeErrorDetails": true,
   "roleClaimType" : "Role"
 }
-```
+```
diff --git a/i18n/it.toml b/i18n/it.toml
@@ -0,0 +1,2 @@
+[get-started]
+   other = "Avvio"
diff --git a/package.json b/package.json
@@ -61,6 +61,6 @@
     "stylelint-config-standard-scss": "^11.0"
   },
   "otherDependencies": {
-    "hugo": "0.139.0"
+    "hugo": "0.148.0"
   }
 }
