非编码人员如何使用 Github 上的程序？

Question

请原谅我的无知，但我对编码一无所知。但是，有很多次我在 GitHub 上看到了非常有趣的程序。问题是我不知道如何使用它们。没有安装文件，我不知道我在做什么。

比如我想使用这里开发的程序：https : //github.com/tonton-pixel/unicopedia-plus。但是当我下载文件时，我不明白如何安装它或让它在我的电脑上运行。

请给出有关如何使用此类程序的非常基本的步骤。

Answer 1

TL; 博士

如果您需要有关安装此特定项目的实际说明，请跳至此答案的底部。事先的一切都更普遍地适用于 GitHub 上的任何类型的项目。

关于 GitHub 发布的快速说明

有时，程序的作者会在 GitHub 上预先构建版本。假设这些文件存在，通常可以通过将“发布”附加到项目 URL 来访问它们，例如https://github.com/tonton-pixel/unicopedia-plus/releases. 也可以通过任何“发布”链接（位于页面右下方，主文件列表旁边）从主项目页面访问它们：

前任。GitHub 发布链接

操作系统支持

并非所有项目都支持所有操作系统。确定一个项目支持哪些平台是下面提到的研究的一部分，即使它没有明确说明。就其价值而言，解释语言的项目往往是跨平台的，而编译语言的项目往往不是（但这不是绝对的）。

概述

有很多次我在 Github 上看到非常有趣的程序。问题是我不知道如何使用它们。

正如在这个问题的其他答案中所提到的，基本过程是做少量研究，看看是否有项目的任何文档。这可以为您提供以下见解：

• 它是一个程序还是一个库？

简而言之，库是通常不能在其他程序之外使用的函数或数据的集合（它们不是独立的）。一些库可能带有以独立方式使用它们的工具，或者带有其他支持工具以在库本身之外使用，但这并不常见。

• 它是用什么语言编写的？

确定编写软件的编程语言有助于确定可能需要哪些附加程序来支持该项目。

• 程序是用编译过的语言编写的还是脚本化的？

这样做的实际影响是脚本语言基本上总是需要至少一个额外的程序（它们的解释器）来运行。编译语言可能需要特殊工具（工具链）来将它们转换为可执行程序，或者（理想情况下）可能已经制作/编译（可能由 GitHub 上的作者，也可能由其他人）。

维基百科提供了编译语言和脚本语言的列表。

• 是否有关于如何使用该软件的演示？

创建软件的人通常会提供项目需求列表（即任何必要的支持软件）和/或有关如何使用该软件的演示。这不是通用的，但同样，这通常可以在项目的文档（如果有）中找到。

• 是否有任何外部网站的链接？

由于各种原因，并非程序/项目所需的所有文档或软件都可以保存在 GitHub 上。在这种情况下，使用 Google 研究软件或注意作者创建的外部链接可能非常有益，因为它们可能包含有关如何使用该软件的线索（或实际说明）。

可能值得一提的是，没有通用的解决方案可以准确确定项目需要什么才能成功运行。如前所述，总是需要进行一些研究。但是，随着您对 GitHub 上托管的项目整体熟悉，最终会出现模式，使使用它们更容易。

一个实际例子

比如我想使用这里开发的程序：https : //github.com/tonton-pixel/unicopedia-plus。但是当我下载文件时，我不明白如何安装它或让它在我的电脑上运行。

1. 它是一个程序还是一个库？

从您链接到的 GitHub 页面来看，项目描述中的短语“包装成一个单一的应用程序”和随附的屏幕截图似乎清楚地表明它具有某种独立的功能（因此它可能不是传统的库）。

2. 它是什么语言？

同样，从项目描述中，它清楚地说明“用 Electron 构建”。如果我们单击提供的链接（标记为“Electron”），我们将被带到Electron Framework 主页，该主页使用 JavaScript、HTML 和 CSS（如其自己的描述中所述）。

因此，我们的应用程序似乎很可能是基于“JavaScript、HTML 和 CSS”构建的。主文件列表中清晰可见的.js和.json文件扩展名似乎证实了这一点：

前任。主文件列表

请注意，这只是要查找整体内容的一个示例。GitHub 在任何“发布”链接下（同样位于页面右下方，主文件列表旁边）提供了项目中使用的语言的细目分类（按百分比）：

前任。GitHub 语言细分

请注意，此功能可能并不总是可用。至少有一个例外似乎包括该网站的移动版本。

3. JavaScript 是编译语言还是脚本语言？

JavaScript 是一种根据维基百科的脚本语言。因此，由于该软件是用 JavaScript 编写的，所以它需要一个额外的程序来运行（解释器，如前所述）。

那么如何在 PC 上运行 JavaScript？这实际上可能是最难确定的部分，但我们有一些线索。如果我们一直向下滚动并阅读主 GitHub 项目页面上的构建部分：

您需要在计算机上安装 Node.js 才能构建此应用程序。

单击标记为“Node.js”的链接会将我们带到Node.js网站，该网站有漂亮、友好、一点也不可怕的安装程序。

4. 是否有关于如何使用该软件的演示？

如果我们阅读建筑部分的下一部分，我们会发现以下说明：

 git clone https://github.com/tonton-pixel/unicopedia-plus
 cd unicopedia-plus
 npm install
 npm start

文字说明

需要注意的是，每当您看到文本说明时，这通常意味着您需要使用终端或命令窗口并键入给出的说明。在 Windows 上，您可以使用cmd.exe（开始菜单？搜索？cmd？Enter）。任何 Mac 或 Linux 发行版都应该有指向相关终端应用程序的显着链接。

前任。Windows 命令窗口 (cmd.exe)

此外，在遵循任何说明之前，您需要安装所有必备软件。在这种情况下，这种方式先安装Node.js的。使用 Windows 安装程序时，应该已经选择了添加node和添加npm到路径的选项（对于步骤 3 和 4 很重要）。

如果您收到有关npm无法在 Windows 中识别的错误（下面的第 3 步）：

• 关闭当前命令窗口，打开一个新窗口，然后重试。

• 您可能需要注销并重新登录以重新加载环境变量。

• 您可能仍然需要手动将 npm 添加到您的 Windows 路径，假设在您的 Node.js 安装过程中标记错误。

Mac/Linux 上类似问题的任何解决方案都应在线提供。

安装 Unicopedia Plus

按照 GitHub 项目页面上给出的步骤：

1. 我们可以忽略git clone https://github.com/tonton-pixel/unicopedia-plus它只是告诉我们使用git下载文件，程序 GitHub 就是以此命名的。作为普通的非程序员，我们只需单击绿色的大“代码”按钮并选择“下载 ZIP”：

前任。GitHub 代码按钮

2. 在我们.zip使用7zip等程序解压缩文件后，我们就可以准备下一条指令了cd unicopedia-plus。在这种情况下，cd是一个切换文件夹（“更改目录”）的命令，它告诉我们需要导航到提取的unicopedia-plus文件夹（这应该包含main.js）。

重要的是要注意，后面的部分cd可能不是 "just" unicopedia-plus。

第二部分可能会有所不同，具体取决于：

• 命令窗口/终端从哪里启动。

• 您存储/提取.zip文件的位置。

• 您下载的文件/文件夹的实际名称是什么（例如版本的“unicopedia-plus-master” .zip）。

对此的解决方案是确定“正确”unicopedia-plus目录的完整路径，并使用它来代替例如cd C:\some\path\to\unicopedia-plus-folderWindows 或cd /some/path/to/unicopedia-plus-folderMac/Linux。

3. 我们遇到的下一条指令是npm install. 为了跳过任何麻烦，我们已经安装了 Node.js，并npm添加到我们的路径（上面）并导航到我们的命令窗口/终端中的正确unicopedia-plus文件夹（包含main.js）（上一步）。

所以我们只需要输入npm install并让安装/构建过程完成它的工作（就像一个普通的安装程序）。

请注意，在此过程中可能会自动下载和安装一些其他要求，因此请确保有可用的 Internet 连接。安装完成后，您将返回到命令行。要有耐心。=)

我们还（假设）做了一些研究，发现它npm是“节点包管理器”，它是一个包含在 Node.js 中的命令行实用程序。npm用于与各种 Node.js 项目（例如我们的项目）“交互”，其中包括安装、管理和用于处理我们已安装的任何内容的界面。

4. 用最后一个命令启动程序npm start。您应该会看到 GitHub 页面上显示的图形用户界面。在测试过程中，这似乎需要大约 30 秒左右的时间，所以再次请耐心等待。=)

在 Windows 上，您可以创建一个批处理文件来启动这个项目，如下所示：

1. 创建一个新的文本文件。

2. 键入类似于以下内容：

    cd "C:\path\to\unicopedia-plus-folder"
    npm start

3. 保存此文件并将文件扩展名从 更改.txt为.bat.

4..bat当您希望启动项目的图形用户界面时，双击（批处理）文件。

您也可以替换C:\path\to\nodejs\npm.cmd start代替npm start，如果你遇到的问题。