Web-Dev-For-Beginners/translations/hk/quiz-app/README.md

測驗應用程式

這些測驗是數據科學課程的課前和課後測驗，課程網址為：https://aka.ms/webdev-beginners

新增翻譯測驗集

透過在 assets/translations 資料夾中建立相應的測驗結構來新增測驗翻譯。原始測驗位於 assets/translations/en。測驗被分成幾個組別。請確保編號與正確的測驗部分對齊。整個課程共有 40 個測驗，編號從 0 開始。

以下是翻譯檔案的結構範例：

[
    {
        "title": "A title",
        "complete": "A complete button title",
        "error": "An error message upon selecting the wrong answer",
        "quizzes": [
            {
                "id": 1,
                "title": "Title",
                "quiz": [
                    {
                        "questionText": "The question asked",
                        "answerOptions": [
                            {
                                "answerText": "Option 1 title",
                                "isCorrect": true
                            },
                            {
                                "answerText": "Option 2 title",
                                "isCorrect": false
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

編輯翻譯後，請編輯翻譯資料夾中的 index.js 檔案，按照 en 的慣例匯入所有檔案。

編輯 assets/translations 中的 index.js 檔案以匯入新的翻譯檔案。

例如，如果你的翻譯 JSON 檔案是 ex.json，請將 'ex' 設為本地化鍵，然後按照以下方式匯入：

index.js

import ex from "./ex.json";

// if 'ex' is localization key then enter it like so in `messages` to expose it 

const messages = {
  ex: ex[0],
};

export default messages;

在本地運行測驗應用程式

先決條件

• 一個 GitHub 帳戶
• Node.js 和 Git

安裝與設置

1. 從這個 範本 建立一個儲存庫

2. 複製你的新儲存庫，並導航到 quiz-app

   git clone https://github.com/your-github-organization/repo-name
   cd repo-name/quiz-app
   

3. 安裝 npm 套件與依賴項

   npm install
   

建置應用程式

1. 要建置解決方案，執行以下指令：

   npm run build
   

啟動應用程式

1. 要運行解決方案，執行以下指令：

   npm run dev
   

[可選] 程式碼檢查

1. 為確保程式碼通過檢查，執行以下指令：

   npm run lint
   

部署測驗應用程式到 Azure

先決條件

• 一個 Azure 訂閱。你可以在 這裡 免費註冊。

  部署此測驗應用程式的成本估算：免費

登入 Azure 後，選擇一個訂閱和資源群組，然後：

• 靜態網頁應用程式詳細資訊：提供一個名稱並選擇一個託管計劃

• GitHub 登入：將部署來源設置為 GitHub，然後登入並填寫表單中的必要欄位：

  • 組織 – 選擇你的組織。
  • 儲存庫 – 選擇 Web Dev for Beginners 課程的儲存庫。
  • 分支 - 選擇一個分支（main）

• 建置預設值：Azure 靜態網頁應用程式使用檢測算法來檢測應用程式中使用的框架。

  • 應用程式位置 - ./quiz-app
  • API 位置 -
  • 輸出位置 - dist

• 部署：點擊 'Review + Create'，然後點擊 'Create'

  部署完成後，一個工作流程檔案將會在你的儲存庫的 .github 目錄中建立。此工作流程檔案包含觸發應用程式重新部署到 Azure 的事件指令，例如，在 main 分支上的 push 等。

  範例工作流程檔案

  以下是 GitHub Actions 工作流程檔案的範例： name: Azure Static Web Apps CI/CD

  on:
  push:
      branches:
      - main
  pull_request:
      types: [opened, synchronize, reopened, closed]
      branches:
      - main
  
  jobs:
  build_and_deploy_job:
      runs-on: ubuntu-latest
      name: Build and Deploy Job
      steps:
      - uses: actions/checkout@v2
      - name: Build And Deploy
          id: builddeploy
          uses: Azure/static-web-apps-deploy@v1
          with:
          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
          repo_token: ${{ secrets.GITHUB_TOKEN }}
          action: "upload"
          app_location: "quiz-app" # App source code path
          api_location: ""API source code path optional
          output_location: "dist" #Built app content directory - optional
  

• 部署後：部署完成後，點擊 'Go to Deployment'，然後點擊 'View app in browser'。

當你的 GitHub Action（工作流程）成功執行後，刷新線上頁面以查看你的應用程式。

免責聲明：
本文件已使用人工智能翻譯服務 Co-op Translator 進行翻譯。雖然我們致力於提供準確的翻譯，但請注意，自動翻譯可能包含錯誤或不準確之處。原始語言的文件應被視為具權威性的來源。對於重要資訊，建議使用專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或錯誤解釋概不負責。