quest get-started

quests/get-started/game.yml

@@ -1,92 +1,83 @@
 title: 終端機的基本知識
 instruction: |
   歡迎來到 Linux Odyssey！
+  在這一關你將會學到：
+  1. 如何使用這個網站
+  2. 如何使用終端機
+
+  在畫面的中間可以看到終端機和提示兩個區塊。
+  請你在終端機中的 `commander:~ $` 後面輸入 `echo start` 並按下 Enter 來開始教程。
 
 stages:
-  - id: help
-    task: 輸入 `echo help` 來朗誦咒語
-    repeatable: false
+  - id: warning-01
+    repeatable: true
     condition:
       command:
-        - .*
-    responses:
-      - type: narrative
-        content:
-          - 你聽到了一個聲音：
-      - type: dialogue
-        speaker: Unix 精靈
-        content:
-          - 你好，指令官，我是你的 Unix 精靈。我已在此恭候多時。
-          - 這個世界是在 3560000 時脈以前，由初代王建立了 Unix 律法，所形成的世界。然而在經過了好幾世代的王後，終於誕生了永恆之王——薩加（Saga），她比歷代的君王都更為強大，且從來不會衰老，使得這個世界變得前所未有的強大。
-          - 然而，外在世界一直不斷在改變，同時在面臨外敵的不斷攻擊，而薩加卻始終用同一套治理的手段。最終，在 160000 時脈前的一次入侵中，根部遭到攻陷，薩加遭到封印，而這個國家也陷入了黑暗。
-          - 由於長久以來依賴於薩加，世人已失去了「指令」的力量，即將走向衰敗和滅亡的命運。
-          - 你的任務，就是找回被世人遺忘的指令，奪回 Linux 之根，成為 Linux 之王。
-          - 首先，你必須要學會如何使用指令。
-          - 你要學習的第一個指令，是「搜索」的指令：`ls` (list)。 `ls` 可以用來查看一個目錄中有哪些檔案。
-          - 現在，請你輸入 `ls` 來查看目前的目錄下有哪些檔案。
-    hints: |
-      ➤  使用 `ls` 指令來查看目前的目錄下有哪些檔案。
-
-  - id: find-scroll
-    task: 搜索卷軸
-    repeatable: false
-    requirements:
-      - help
-    condition:
-      command:
-        - ls
-    responses:
-      - type: narrative
-        content:
-          - 一瞬間，視野變得清晰起來，你發現自己身處在一個石頭建築的房間裡。
-          - 你發現了一個檔案，檔名是 `forgotten-scroll.txt`。
-      - type: dialogue
-        speaker: Unix 精靈
-        content:
-          - 你找到了一個被遺忘的卷軸，上面寫著解除封印的咒語。
-          - 使用指令 `cat [ 檔案名稱 ]` (concatenate)來查看檔案內容。
-          - 我可以為你提供一些指令的提示，只要輸入指令的前幾個字元，然後按下 `Tab` 鍵，就可以看到提示了。
-          - 例如你只要輸入檔案名稱的前幾個字元，然後按下 `Tab` 鍵，就可以看到提示了。
+        - '　'
     hints:
-      - 使用 `cat [ 檔案名稱 ]` 指令來查看檔案內容。
-      - 使用 `Tab` 鍵來取得指令提示。
-      - 如果卡在未知的情況，按下 `Ctrl + C` 嘗試離開。
+      - '!! 請勿使用全形空格 !!'
 
-  - id: read-forgotten-scroll
-    task: 查看卷軸
-    repeatable: false
-    requirements:
-      - find-scroll
+  - id: start
+    task: 輸入 `echo start` 來開始教程
     condition:
-      pwd:
-        - '^/home/commander$'
-      command:
-        - cat forgotten_scroll.txt
+      output:
+        - ^start$
     responses:
-      - type: dialogue
-        speaker: Unix 精靈
-        content:
-          - 你找到的是一個被遺忘的卷軸，上面寫著解除封印的咒語。
-          - 使用你已經知道的 `echo [ 咒語 ]` 指令來詠唱咒語。
-    hints: |
-      ➤  輸入 `echo Hello World` 來詠唱咒語。
+      - content:
+          - 你好，我是你的 Unix 助手，我叫做 Ada。我將會在之後協助你了解如何使用終端機。
+          - 現在所在的這個區塊就是終端機，你可以在這裡輸入指令來操作電腦。
+          - 在終端機中，你所看到的
+          - '`commander:~ $` 是指令提示符號，它能讓你知道現在可以輸入指令了。'
+          - 你必須將指令輸入在它的後方。
+          - 當你輸入完指令並按下 Enter 之後，終端機會執行你輸入的指令。
+          - 並且會將執行結果輸出在終端機的下一行。
+          - 這個終端機的功能和你在 Linux 電腦上看到的終端機是一樣的。
+          - 唯一的差別是，在這裡會有劇情和提示來協助你學習如何使用終端機。
+          - 在輸入指令之後，如果你看到用綠色 `=====` 組成的分隔線，代表在分隔線下方的內容是添加的內容，在真實的終端機中不會出現。
+          - 而終端機的輸出，是在綠色 `=====` 分隔線上方的白色內容。
+          - 現在請你輸入 `echo hello` 來看看會發生什麼事。
+    hints:
+      - ➤  在 `commander:~ $` 後面輸入 `echo hello` 並按下 Enter
+
+  - id: echo-hello
+    task: 在終端機輸入 `echo hello`
+    requirements:
+      - start
+    condition:
+      command:
+        - ^echo hello$
+    responses:
+      - content:
+          - 你應該可以看到終端機上顯示了：
+          - commander:~ $ echo hello
+          - hello
+          - 第一行的 `commander:~ $` 是指令提示符， `echo hello` 是你輸入的指令。
+          - 第二行的 `hello` 則是終端機的輸出。
+      - content:
+          - 現在你知道如何在終端機上輸入指令，以及查看終端機輸出的位置。
+          - 指令必須輸入在指令提示符號的後面，然而當指令提示符消失時，你就無法輸入指令了。
+          - 這時候你可以按下 `Ctrl + C` 來嘗試解決這個問題。
+          - 在終端機中， `Ctrl + C` 並不能用來複製，而是用來中斷目前正在執行的指令。
+          - 因此，如果你前一次的指令執行時卡住了，或是執行很久沒有反應，你可以按下 `Ctrl + C` 來中斷指令，讓你可以繼續輸入指令。
+          - 如果 `Ctrl + C` 也沒有辦法解決問題，可以按按看 `esc` 或 `q` 鍵。如果都沒用的話，按下畫面右下角的 `重來` 按鈕重新開始關卡。
+      - content:
+          - 在終端機下方會顯示提示，你可以用提示右上角的箭頭來查看之前的提示。
+          - 在畫面左邊的區域是關卡說明，你可以在這裡看到關卡的介紹，以及現在需要完成的任務。
+          - 在畫面右邊的區域是檔案樹，它會根據你所探索的資料夾發生變化，讓你更清楚檔案之間的位置關係。
+          - 畫面右上角的圖示分別是 `查看地圖`、`回報錯誤` 以及 `登出` 按鈕。
+      - content:
+          - 第一關的文字內容比較多，可以慢慢讀沒關係。
+          - 如果忘記了也可以隨時回來複習。
+          - 需要的話可以按下 `Enter` 來快速跳過劇情說明。
+          - 如果你已經讀完了上述內容，請輸入 `echo finish` 來結束這一關。
+    hints:
+      - ➤  按下 `Ctrl + C` 能夠中斷指令
+      - ➤  劇情進行時可以按下 `Enter` 來快速跳過
 
   - id: END
-    task: 解除封印
-    repeatable: false
+    task: 結束關卡
     requirements:
-      - read-forgotten-scroll
+      - echo-hello
     condition:
-      pwd:
-        - '^/home/commander$'
       command:
-        - echo [Hh]ello\s*[Ww]orld
-    responses:
-      - type: narrative
-        content:
-          - 突然之間，你感覺到一股強大的力量從你的身體中湧出，你的身體開始發光，你的手中出現了一把魔法之劍。
-      - type: dialogue
-        speaker: Unix 精靈
-        content:
-          - 恭喜您，我的指令官，您已成功解除了封印。
-          - 請跟著在接下來的關卡，一步步取回 Linux 之根吧！
+        - ^echo finish$