非程序员如何使用 Github 上的程序?

非程序员如何使用 Github 上的程序?

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

例如我想使用这里开发的程序:https://github.com/tonton-pixel/unicopedia-plus。但是当我下载文件时,我不知道如何在我的计算机上安装它或让它运行。

请提供如何使用此类程序的基本步骤。

答案1

总结

如果您需要有关安装此特定项目的实际说明,请跳至此答案的底部。之前的所有内容更普遍地适用于 GitHub 上的任何类型的项目。

关于 GitHub 发布的简要说明

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

例如 GitHub 发布链接

GitHub 发布链接示例 - 屏幕截图。GitHub 主 Web 界面的裁剪图像以红色方块标记。标记区域内的文本链接为发布,90,指向项目的所有 GitHub 发布列表。发布,90 下方的单独文本链接链接到最新版本,标识符为 7 点 11 点 1,GitHub 生成的标签为最新。此外,该链接下方的文本标签为 3 天前。此最新版本链接指向仅针对该 GitHub 版本的页面,未列出其他版本。最新版本链接下方的第三个也是最后一个文本链接为 + 89 发布,指向与发布,90 相同的页面

操作系统支持

并非所有项目都支持所有操作系统。确定项目支持哪些平台是下文提到的研究的一部分,尽管没有明确说明。值得一提的是,解释语言中的项目往往是跨平台的,而编译语言中的项目往往不是跨平台的(但这不是绝对的)。


概述

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

正如该问题的其他答案所暗示的那样,基本流程是进行少量研究,看看是否有该项目的任何文档。这可以为您提供以下见解:

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

简而言之,库是函数或数据的集合,通常不能在其他程序之外使用(它们不是独立的)。一些库可能附带工具以独立方式使用它们,或者与其他支持工具一起在库本身之外使用,但这种情况并不常见。

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

确定软件所采用的编程语言可以帮助确定可能需要哪些额外的程序来支持该项目。

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

列表编译语言脚本语言可从维基百科获取。

  • 有没有关于如何使用该软件的演示?

软件的创建者通常会提供项目需求列表(即任何必要的支持软件)和/或如何使用该软件的演示。这并不通用,但同样,这通常在项目文档(如果有)中找到。

  • 有任何外部网站的链接吗?

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

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


一个实际的例子

例如我想使用这里开发的程序:https://github.com/tonton-pixel/unicopedia-plus。但是当我下载文件时,我不知道如何在我的计算机上安装它或让它运行。

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

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

  1. 它使用什么语言?

同样,从项目描述中,它清楚地表明“使用 Electron 构建”。如果我们点击提供的链接(标记为“Electron”),我们将被带到Electron 框架主页,它使用 JavaScript、HTML 和 CSS(如其自身描述中所述)。

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

例如主要文件列表

JavaScript 文件扩展名示例 - 屏幕截图。GitHub 主 Web 界面的裁剪图像显示了源代码文件和文件夹的列表。主列表中的几个单个文件用红色方块标记。这些文件按顺序命名为 main dot JS、package hyphen lock dot jay sun、JSON、package dot jay sun、JSON 和 settings dot jay sun、JSON

请注意,这只是总体上需要注意的事项的一个例子。GitHub 在任何“发布”链接下提供了项目中使用的语言的细分(按百分比)(同样,位于页面右下部分,主文件列表旁边):

例如 GitHub 语言细分

GitHub 语言细分栏示例 - 屏幕截图。GitHub 主网页界面的裁剪图像显示了一个由不同比例的黄色、橙色和紫色组成的彩色栏。栏下方是 GitHub 生成的文本标签,按百分比显示项目的语言使用情况。它们分别名为 JavaScript,80 点 3%,标有黄色圆点;HTML,18 点 2%,标有橙色圆点;CSS,1 点 5%,标有紫色圆点


请注意,这种语言细分可能并不总是立即可见。最近,GitHub 选择将此细分放在其 Web 界面的相对底部。在网站的移动版本上,至少在某些情况下,它实际上是向下滚动时列出的最后一项。


  1. JavaScript 是编译型语言还是脚本型语言?

JavaScript 是一种维基百科的脚本语言。因此,由于该软件是用 JavaScript 编写的,因此需要额外的程序才能运行(解释器,如前所述)。

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

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

点击标有“Node.js”的链接将带我们进入Node.js网站安装人员很友好,一点也不吓人

  1. 有没有关于如何使用该软件的演示?

如果我们读下一部分建筑部分,我们发现了这些说明:

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

文字说明

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

例如 Windows 命令窗口 (cmd.exe)

Windows 命令窗口 CMD - 屏幕截图。Windows 命令控制台的裁剪图像显示一行文本 git、clone、https://github.com/tonton-pixel/unicopedia-plus

此外,在按照任何说明操作之前,您需要安装所有必备软件。在本例中,这意味着首先安装 Node.jsnode. 使用 Windows 安装程序时,应该已经选择了将和添加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 代码按钮

GitHub Code 按钮 - 屏幕截图。GitHub 主网页界面的裁剪图像显示一个绿色的按钮链接,标题为 Code。在其下方,HTML 生成的子菜单提供了三个选项链接。这些链接分别名为 Clone with HTTPS、Open with GitHub Desktop 和 Download Zip。最后一个链接 Download Zip 标有红色方块

  1. 我们.zip使用如下程序提取文件后7zip,我们已准备好执行下一个指令cd unicopedia-plus。在本例中,cd是切换文件夹(“更改目录”)的命令,它告诉我们需要导航到提取的unicopedia-plus文件夹(其中应该包含main.js)。

这里需要注意的是,后面的部分cd可能并不“公正” unicopedia-plus

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

  • 命令窗口或终端的启动位置。

  • 您选择存储或提取.zip文件的位置。

  • 您下载的文件或文件夹的实际名称(例如,版本为“unicopedia-plus-master” .zip)。

解决这个问题的方法是确定“正确”本地unicopedia-plus目录的完整路径,并使用该路径,例如cd C:\some\path\to\unicopedia-plus-folder对于 Windows 或cd /some/path/to/unicopedia-plus-folderMac 和 Linux。


  1. 我们遇到的下一个指令是npm install。为了避免任何麻烦,我们已经安装了 Node.js 并将其npm添加到我们的路径中(上面),并在命令窗口或终端中导航到正确的unicopedia-plus文件夹(包含 的文件夹main.js)(上一步)。

因此我们只需输入npm install并让安装/构建过程完成其工作(就像普通安装程序一样)。

请注意,在此过程中可能会自动下载并安装一些其他要求,因此请确保互联网连接正常。安装完成后,您将返回命令行。请耐心等待。=)


我们还(假设)做了一些研究,发现它npm是“节点包管理器”,是 Node.js 中包含的命令行实用程序。npm用于与各种 Node.js 项目(例如我们的项目)“交互”,其中包括安装、管理和与我们安装的任何东西一起工作的界面。


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

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

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

2. 输入类似以下内容:

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

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

.bat4.当您希望启动项目的图形用户界面时,双击(批处理)文件。

如果遇到问题,您可以用替代C:\path\to\nodejs\npm.cmd start来代替。npm start


答案2

您的示例中的应用程序在电子上运行,因此您应该用 Google 搜索如何运行这样的应用程序,并且您应该找到官方文档。

对于您的示例,我已经为您完成了,并找到了文档,请转到:https://electronjs.org/docs/tutorial/first-app#trying-this-example

您还会发现在某些情况下自述文件也非常有用。

我没有针对您的示例提供逐步的指导,而只是提供了更为通用的答案,以便您将来可以自己做这样的事情。

答案3

寻找建筑或者安装github 项目的部分。

在这种情况下,它们是:

unicopedia-plus 的构建说明

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

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

如何遵循上述说明

  1. 安装git,使用 github 的核心工具
  2. 前往 nodejs.org,下载并安装 node.js
  3. 在终端(或命令提示符)中执行上述命令。一次性复制并粘贴它们应该没问题
  4. 按照终端上打印的说明进行操作(如果有)

大多数项目基本上都会遵循上述三个步骤进行构建/安装。

如果不容易破译建造或者安装在 github 项目上可以找到说明,很可能该软件还没有准备好供开发人员使用。

相关内容