update tutorial pages (#96)

b00f · web-flow · commit bdb72ca8cee4 · 2026-01-08T12:37:17.000+08:00
diff --git a/content/protocol/_index.md b/content/protocol/_index.md
@@ -1,5 +1,5 @@
 ---
-title: 📔 Protocol
+title: 📚 Protocol
 weight: 2
 prev: /get-started/
 next: /tutorials/
diff --git a/content/protocol/consensus/proof-of-stake.md b/content/protocol/consensus/proof-of-stake.md
@@ -1,5 +1,5 @@
 ---
-title: Solid State Proof of Stake
+title: Solid-State Proof of Stake
 weight: 1
 ---
 
diff --git a/content/protocol/consensus/protocol.md b/content/protocol/consensus/protocol.md
@@ -1,5 +1,5 @@
 ---
-title: Protocol
+title: Consensus Protocol
 weight: 2
 math: true
 ---
diff --git a/content/protocol/transaction/format.md b/content/protocol/transaction/format.md
@@ -1,5 +1,5 @@
 ---
-title: Format
+title: Transaction Format
 weight: 1
 math: false
 ---
diff --git a/content/tutorials/_index.md b/content/tutorials/_index.md
@@ -1,5 +1,5 @@
 ---
-title: 📚 Tutorials
+title: 🎓 Tutorials
 weight: 3
 prev: /protocol/
 next: /api/
diff --git a/content/tutorials/grpc-basic-auth.md b/content/tutorials/grpc-basic-auth.md
@@ -1,5 +1,5 @@
 ---
-title: How to Secure gRPC Using Basic Authentication?
+title: Secure gRPC Using Basic Authentication
 weight: 6
 ---
 
@@ -67,7 +67,7 @@ For additional security, you can save the web page locally and run it on an offl
   </button>
   <br>
   <br>
-  <p id="output"></p>
+  <div id="output" class="hextra-code-block"></div>
 </form>
 
 ## Enable Basic Auth in the Config
diff --git a/content/tutorials/grpc-sign-transactions.md b/content/tutorials/grpc-sign-transactions.md
@@ -1,5 +1,5 @@
 ---
-title: How to Sign Transactions Using gRPC?
+title: Sign Transactions Using gRPC
 weight: 5
 ---
 
diff --git a/content/tutorials/linux-systemd.md b/content/tutorials/linux-systemd.md
@@ -1,5 +1,5 @@
 ---
-title: How to Run Pactus with systemd on Linux?
+title: Run Pactus with systemd on Linux
 weight: 10
 ---
 
@@ -21,7 +21,7 @@ Before setting up Pactus to run with systemd, ensure you have the following:
 
 To create a systemd service for Pactus, follow these steps:
 
-1. **Initialize the Pactus Node**: Before running the service, initialize the Pactus node by this command:
+1. **Initialize the Pactus Node**: Before running the service, initialize the Pactus node with this command:
 
   ```shell
   pactus-daemon init
diff --git a/content/tutorials/pactus-metrics.md b/content/tutorials/pactus-metrics.md
@@ -1,5 +1,5 @@
 ---
-title: How to run Pactus Metrics?
+title: Run Pactus Metrics
 weight: 9
 ---
 
@@ -17,20 +17,20 @@ Before proceeding with the steps below, ensure that you have the following:
 
 ## Configure Pactus Node for Metrics
 
-To Configure the Pactus Node for Metrics, navigate to the Pactus directory; by default, it’s located at the following path.
+To configure the Pactus node for metrics, navigate to the Pactus directory. By default, it’s located at:
 
 ```text
 /home/YourUsername/pactus
 ```
 
 There’s a file named `config.toml` that contains all the configurations for your node.
-There are two parameters that you should enable for metrics: the first is `enable_metrics`,
-and the second is enable `http`. After editing the `config.toml` you should restart your node.
-The metrics now can be accessed at `http://localhost:80/metrics/prometheus` (this url going to be use by prometheus).
+Enable two parameters for metrics: `enable_metrics` and `http.enable`.
+After editing `config.toml`, restart your node.
+Metrics are available at `http://localhost:80/metrics/prometheus` (this URL will be used by Prometheus).
 
 {{< callout type="info" >}}
 
-if you are running Pactus with docker image, make sure to expose :80 port.
+If you are running Pactus with the Docker image, make sure to expose port 80.
 
 {{< /callout >}}
 
@@ -70,9 +70,8 @@ volumes: prom_data
 ```
 
 You can change the default username and password of Grafana by modifying the values of `GF_SECURITY_ADMIN_USER` and `GF_SECURITY_ADMIN_PASSWORD`.
-Now, save the file. Then, in the current directory (meaning you are inside the `prometheus-grafana` directory),
-create another directory named `grafana`. Then, go to the directory. So now you're in the path `/prometheus-grafana/grafana/`.
-In the current directory, create a file named `datasource.yml` and paste the code below there.
+Save the file. From the same `prometheus-grafana` directory, create a `grafana` directory and enter it (`/prometheus-grafana/grafana/`).
+In that directory, create a file named `datasource.yml` and paste the code below.
 
 ```yaml
 apiVersion: 1
@@ -86,10 +85,9 @@ datasources:
     editable: true
 ```
 
-Then save the file and exit.
-Now, we should go up one directory level from the current directory and navigate to the `/prometheus-grafana` directory.
-In the current directory, which is `/prometheus-grafana`, create another directory named `prometheus`,
-then go into the directory.In the prometheus directory create a file named `prometheus.yml` and paste below code there.
+Save the file and exit.
+Go up one directory level back to `/prometheus-grafana`.
+Create a `prometheus` directory, enter it, and create a file named `prometheus.yml` with the content below.
 
 ```yaml
 global:
@@ -119,10 +117,10 @@ Then save the file and exit.
 
 {{< callout type="info" >}}
 
-Tip: In the last section of the code, you will see the targets section where I've written 127.0.0.1.
-You can change it based on your localhost IP or your website domain.
-Please be aware that your target should match with your node http port.
-The default http port of pactus node is 80.
+Tip: In the last section of the code, you will see the targets section where 127.0.0.1 is set.
+You can change it based on your localhost IP or your domain.
+Please ensure that your target matches your node's HTTP port.
+The default HTTP port of a Pactus node is 80.
 
 {{< /callout >}}
 
diff --git a/content/tutorials/pactus-shell.md b/content/tutorials/pactus-shell.md
@@ -1,11 +1,11 @@
 ---
-title: How to use Pactus Shell?
+title: Use Pactus Shell
 weight: 3
 ---
 
 Pactus Shell is a command-line tool designed for interacting with the Pactus blockchain.
-This tool receives the commands from the terminal and send them to the node using gRPC.
-The resulting response is then displayed as a structured [JSON](https://www.json.org) format.
+This tool receives commands from the terminal and sends them to the node using gRPC.
+The resulting response is then displayed in a structured [JSON](https://www.json.org) format.
 
 You can execute `pactus-shell` with the `-h` flag to display available commands for communicating with your node.
 
diff --git a/content/tutorials/pactus-testnet.md b/content/tutorials/pactus-testnet.md
@@ -1,5 +1,5 @@
 ---
-title: How to join Pactus Testnet?
+title: Join Pactus Testnet
 weight: 13
 ---
 
@@ -13,7 +13,7 @@ It also helps the development team test and improve Pactus more effectively.
 
 This document provides a step-by-step guide on how to join the Pactus testnet.
 
-## Setup node
+## Set up the node
 
 To set up a Testnet node, first [download](https://pactus.org/download/) the latest version of Pactus.
 The Testnet uses the same software as the Mainnet, but it must be configured to connect to the Testnet.
@@ -30,15 +30,15 @@ To join the Testnet, you need to explicitly specify the `--testnet` flag when in
 ./pactus-daemon init --working-dir=~/pactus/testnet --testnet
 ```
 
-This command creates your wallet and setup the working directory at `~/pactus/testnet`.
+This command creates your wallet and sets up the working directory at `~/pactus/testnet`.
   {{< /os_tab >}}
   {{< os_tab >}}
 
 ```batch
 pactus-daemon.exe init --working-dir=%USERPROFILE%\pactus\testnet --testnet
 ```
 
-This command creates your wallet and setup the working directory at `C:\Users\<USER_NAME>\pactus\testnet`.
+This command creates your wallet and sets up the working directory at `C:\Users\<USER_NAME>\pactus\testnet`.
   {{< /os_tab >}}
 {{< /os_tabs >}}
 
diff --git a/content/tutorials/pactus-wallet.md b/content/tutorials/pactus-wallet.md
@@ -1,5 +1,5 @@
 ---
-title: How to use Pactus Wallet?
+title: Use Pactus Wallet
 weight: 2
 ---
 
diff --git a/content/tutorials/pruned-nodes.md b/content/tutorials/pruned-nodes.md
@@ -1,5 +1,5 @@
 ---
-title: How to use Prune Node?
+title: Use Pruned Nodes
 weight: 4
 ---
 
diff --git a/content/tutorials/reduce-network.md b/content/tutorials/reduce-network.md
@@ -1,39 +1,31 @@
 ---
-title: How to reduce the network usage?
+title: Reduce Network Usage
 weight: 8
 ---
 
 ## Preface
 
 Pactus is designed for low traffic usage.
 However, some users still face bandwidth limitations imposed by their Internet Service Providers (ISPs).
-This guide will explore effective ways to reduce networking usage for a Pactus node.
+This guide will explore effective ways to reduce network usage for a Pactus node.
 
-### Reducing the number of connection
+## Reducing the number of connections
 
 By default, Pactus attempts to maintain 64 open connections with other nodes,
 with 1/4 of these as outbound connections and the remaining as inbound connections.
-To reduce networking usage, you can decrease this maximum number of connections.
+To reduce network usage, you can decrease this maximum number of connections.
 However, it's important to remember that more connections with
 peers usually enable the node to function more effectively and securely.
-The `max_connections` setting in the config file can be adjusted to manage the maximum number of connections.
+The `max_connections` setting in the [config](/get-started/configuration/) file
+can be adjusted to manage the maximum number of connections.
 
-### Disabling Relay
+## Disabling Relay
 
 A relay connection is a type of connection that can be established between two peers,
 usually behind a NAT, by a third-party peer known as a relay.
-This is especially helpful when users run Pactus on a private network like home internet.
+This is especially helpful when users run Pactus on a private network like a home network.
 However, the relay connection is not as stable as a direct connection.
 Disabling the relay connection may reduce network usage.
 If you have a reliable and public IP address, you can disable the relay connection.
 The relay connection is enabled by default. To disable the relay connection,
-set `enable_relay` to `false` inside the config file.
-
-### Disabling Node-Network service
-
-A node-network is a type of node that provides historical data, such as blocks,
-to other nodes so they can sync with the network.
-By default, this service is enabled.
-Disabling this service helps reduce traffic usage.
-Keep in mind that new nodes rely on other nodes to be able to sync.
-To disable the node-network service, set `node_network` to `false`.
+set `enable_relay` to `false` inside the [config](/get-started/configuration/) file.
diff --git a/content/tutorials/secure-connections.md b/content/tutorials/secure-connections.md
@@ -1,5 +1,5 @@
 ---
-title: How to Secure Connections?
+title: Secure Connections
 weight: 7
 ---
 
diff --git a/content/tutorials/send-transaction-gui.md b/content/tutorials/send-transaction-gui.md
@@ -1,5 +1,5 @@
 ---
-title: How to send transactions in Graphic Mode?
+title: Send Transactions in Graphic Mode
 weight: 1
 ---
 
@@ -28,8 +28,8 @@ click on the "Send" button to sign and broadcast the transaction to the Pactus b
 
 ![Transfer Transaction Dialog](/images/transfer-transaction-dialog.png)
 
-When sending or receiving a transaction from either exchange or another person that's not you,
-it is important to use a memo to ensure the transaction is attributed to the intended recipient.
+Some exchanges and third-party services require a memo/tag to credit deposits correctly.
+If the recipient provides a memo, include it to ensure the transaction is attributed properly.
 
 ## Sending a Bond Transaction
 
diff --git a/content/tutorials/software-verification.md b/content/tutorials/software-verification.md
@@ -1,5 +1,5 @@
 ---
-title: How to Verify Pactus Software Is Safe?
+title: Verify Pactus Software Is Safe
 weight: 11
 ---
 
diff --git a/content/tutorials/zero-fee-transactions.md b/content/tutorials/zero-fee-transactions.md
@@ -1,5 +1,5 @@
 ---
-title: How to Send Zero-Fee Transactions?
+title: Send Zero-Fee Transactions
 weight: 12
 ---
 
diff --git a/layouts/_shortcodes/basic-auth.html b/layouts/_shortcodes/basic-auth.html
@@ -5,17 +5,28 @@
   var bcrypt = dcodeIO.bcrypt;
 
   function generateHtpasswd(event) {
+    function printOutput(message) {
+      document.getElementById("output").innerHTML = "<pre>" + message + "</pre>";
+    }
+
     event.preventDefault(); // Prevent the form from submitting
     var username = document.getElementById("username").value;
     var password = document.getElementById("password").value;
+
+    // if password is empty, show an error message
+    if (password === "") {
+      printOutput("Password is required");
+      return;
+    }
+
     // Ensure that bcrypt is properly loaded
     if (typeof bcrypt !== 'undefined') {
       var salt = bcrypt.genSaltSync(10);
       var hash = bcrypt.hashSync(password, salt);
       var htpasswd = username + ":" + hash;
-      document.getElementById("output").innerHTML = "<pre>" + htpasswd + "</pre>";
+      printOutput(htpasswd);
     } else {
-      console.error("bcrypt library is not loaded.");
+      printOutput("bcrypt library is not loaded.");
     }
   }
 </script>
