update prune docu (#109)

Author: b00f

.github/workflows/check.yml

@@ -43,7 +43,7 @@ jobs:
     name: HTML proofer
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.152.2
+      HUGO_VERSION: 0.161.1
 
     steps:
       - name: Checkout

.github/workflows/deploy.yml

@@ -31,7 +31,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.152.2
+      HUGO_VERSION: 0.161.1
 
     steps:
       - name: Checkout

assets/css/custom.css

@@ -65,6 +65,13 @@ input[type="password"]:focus {
   white-space: nowrap;
   text-overflow: ellipsis;
 }
+
 .hextra-scrollbar ul  {
   overflow-x:auto;
 }
+
+/* Remove radius from code blocks */
+.hextra-code-block pre,
+.hextra-code-block code {
+  border-radius: 0 !important;
+}

content/tutorials/pruned-nodes.md

@@ -1,5 +1,5 @@
 ---
-title: Prune Your Pactus Node
+title: Running a Pruned Node
 weight: 4
 ---
 
@@ -39,15 +39,21 @@ enabling more participants to run nodes and contribute to network security and d
 
 If you are running a Full Node and want to prune its data to operate in pruned mode, follow these steps:
 
-1. **Stop the Running Node**
-   Shut down your currently running Pactus full node completely.
+{{% steps %}}
 
-2. **Open a Terminal or Command Prompt**
+#### Step 1
+
+Stop your node if it's running.
+
+#### Step 2
+
+Open a Terminal or Command Prompt:
    - On **macOS/Linux**: Open the **Terminal**.
    - On **Windows**: Use **Command Prompt** or **PowerShell**.
 
-3. **Prune the Node Data**
-   Run the following command, replacing `<PATH-TO-WORKING-DIR>` with the actual path to your working directory:
+#### Step 3
+
+Run the following command, replacing `<PATH-TO-WORKING-DIR>` with the actual path to your working directory:
 
 {{< os_tabs items="unix,windows" >}}
   {{< os_tab >}}
@@ -66,11 +72,88 @@ pactus-daemon.exe prune -w <PATH-TO-WORKING-DIR>
   {{< /os_tab >}}
 {{< /os_tabs >}}
 
-4. **Restart the Node**
-   Start your Pactus node again to resume normal operation.
+#### Step 4
+
+Start your Pactus node again to resume normal operation.
+
+{{% /steps %}}
 
 This process removes all blocks and transactions older than your configured `store.retention_days`
 (default: 10 days). You can adjust it in your node
 [config](/get-started/configuration/) if you want to keep more
 or less history.
 Pruning is especially useful for users with limited storage capacity.
+
+## Importing a Blockchain Snapshot (Pruned Mode)
+
+To get your node up and running quickly, you can import a recent pruned snapshot of the blockchain.
+This is much faster than syncing from the genesis block.
+
+{{< callout type="warning" >}}
+   Before importing, make sure your node is **completely stopped**.
+   Importing while the node is running can corrupt your data.
+{{< /callout >}}
+
+### Option 1: Automatic Import (Recommended)
+
+The `import` command automates the process.
+
+{{% steps %}}
+
+#### Step 1
+
+Stop your node if it's running.
+
+#### Step 2
+
+Run the import command:
+{{< os_tabs items="unix,windows" >}}
+{{< os_tab >}}
+
+```shell
+./pactus-daemon import --working-dir=<PATH-TO-WORKING-DIR>
+```
+
+{{< /os_tab >}}
+{{< os_tab >}}
+
+```shell
+./pactus-daemon.exe import --working-dir=<PATH-TO-WORKING-DIR>
+```
+
+{{< /os_tab >}}
+{{< /os_tabs >}}
+
+*(Replace `<PATH-TO-WORKING-DIR>` with your node's working directory).*
+
+The daemon will automatically download and import the latest official snapshot from https://snapshot.pactus.org/.
+
+#### Step 3
+
+Start your node normally after the import finishes.
+
+{{% /steps %}}
+
+### Option 2: Manual Import
+
+Use this method if you want to choose a specific snapshot or download it manually.
+
+{{% steps %}}
+
+#### Step 1
+
+Stop your node if it's running.
+
+#### Step 2
+
+Download a snapshot from https://snapshot.pactus.org/. Each snapshot shows its creation date, file size, and a SHA256 checksum for verification.
+
+#### Step 3
+
+Extract the archive directly into your node's working directory. The extracted contents should go into the `data` folder inside the working directory (e.g., `~/pactus/data/`).
+
+#### Step 4
+
+Start your node normally. It will resume operation from the imported state.
+
+{{% /steps %}}

go.mod

@@ -2,4 +2,4 @@ module github.com/pactus-project/docs
 
 go 1.21.9
 
-require github.com/imfing/hextra v0.9.7 // indirect
+require github.com/imfing/hextra v0.12.3 // indirect

go.sum

@@ -1,2 +1,2 @@
-github.com/imfing/hextra v0.9.7 h1:Zg5n24us36Bn/S/5mEUPkRW6uwE6vHHEqWSgN0bPXaM=
-github.com/imfing/hextra v0.9.7/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI=
+github.com/imfing/hextra v0.12.3 h1:DZHY2rUWYteyzjlHi9r4n7Bb5e2Q+6LXe4C1Dqn0ZjM=
+github.com/imfing/hextra v0.12.3/go.mod h1:vi+yhpq8YPp/aghvJlNKVnJKcPJ/VyAEcfC1BSV9ARo=

hugo.yaml

@@ -116,4 +116,3 @@ params:
       # date | lastmod | publishDate | title | weight
       sortBy: date
       sortOrder: desc # or "asc"
-

layouts/_shortcodes/items.html

@@ -1,4 +1,4 @@
-<div class="hextra-cards hx-mt-4 hx-gap-4 hx-grid not-prose" style="--hextra-cards-grid-cols: 3;">
+<div class="hextra-cards hx:mt-4 hx:gap-4 hx:grid not-prose" style="--hextra-cards-grid-cols: 1;">
 {{ range .Page.RegularPages }}
     {{- partial "shortcodes/card" (dict
         "page"        .Page

layouts/_shortcodes/os_tab.html

@@ -3,7 +3,7 @@
 {{- $defaultIndex := int ((.Parent.Get "defaultIndex") | default "0") -}}
 
 <div
-  class="hextra-tabs-panel hx-rounded hx-pt-6 hx-hidden data-[state=selected]:hx-block"
+  class="hextra-tabs-panel hx:pt-0 hx:hidden hx:data-[state=selected]:block"
   id="tabs-panel-{{ .Ordinal }}"
   role="tabpanel"
   {{- if eq .Ordinal $defaultIndex }} tabindex="0" {{ end -}}

layouts/_shortcodes/os_tabs.html

@@ -7,8 +7,8 @@
   {{ errorf "no items provided" }}
 {{- end -}}
 
-<div class="hextra-scrollbar hx-overflow-x-auto hx-overflow-y-hidden hx-overscroll-x-contain">
-  <div class="hx-mt-4 hx-flex hx-w-max hx-min-w-full hx-border-b hx-border-gray-200 hx-pb-px dark:hx-border-neutral-800">
+<div class="hextra-scrollbar hx:overflow-x-auto hx:overflow-y-hidden hx:overscroll-x-contain ">
+  <div class="hx:mt-4 hx:flex hx:w-max hx:min-w-full hx:border-b hx:border-gray-200 hx:pb-px hx:dark:border-neutral-800" role="tablist">
     {{- range $i, $item := $items -}}
 
       {{- $itemDisplay := $item | safeHTML -}}
@@ -26,7 +26,7 @@
       {{- end -}}
 
       <button
-        class="hextra-tabs-toggle data-[state=selected]:hx-border-primary-500 data-[state=selected]:hx-text-primary-600 data-[state=selected]:dark:hx-border-primary-500 data-[state=selected]:dark:hx-text-primary-600 hx-mr-2 hx-rounded-t hx-p-2 hx-font-medium hx-leading-5 hx-transition-colors -hx-mb-0.5 hx-select-none hx-border-b-2 hx-border-transparent hx-text-gray-600 hover:hx-border-gray-200 hover:hx-text-black dark:hx-text-gray-200 dark:hover:hx-border-neutral-800 dark:hover:hx-text-white"
+        class="hextra-tabs-toggle hx:cursor-pointer hx:data-[state=selected]:border-primary-500 hx:data-[state=selected]:text-primary-600 hx:data-[state=selected]:dark:border-primary-500 hx:data-[state=selected]:dark:text-primary-600 hx:mr-2 hx:rounded-t hx:p-2 hx:font-medium hx:leading-5 hx:transition-colors hx:-mb-0.5 hx:select-none hx:border-b-2 hx:border-transparent hx:text-gray-600 hx:hover:border-gray-200 hx:hover:text-black hx:dark:text-gray-200 hx:dark:hover:border-neutral-800 hx:dark:hover:text-white hx:hextra-focus-visible-inset"
         role="tab"
         type="button"
         aria-controls="tabs-panel-{{ $i }}"