vitalgg 发表于 2022-5-25 04:46:29

@lisp 项目:开源协同开发 首次试水必读

本帖最后由 vitalgg 于 2022-5-30 06:00 编辑

原文地址: https://gitee.com/atlisp/service ... 5%BF%85%E8%AF%BB.md
点此加入 @lisp 开发团队,6月1日前有效。
全网搜寻 lisp开发, wiki 文档创作, 代码审核,宣传推广等。



我们是怎样协同开发的



# 首次使用

## 第一步 准备工具
从网络下载 Git 工具。

https://pan.baidu.com/s/1rpfm3pLYIU3wS1V4gXLN0w?pwd=zgl5

双击,安装,建议安装位置 `D:/PortableGit/` 。

我们双击打开 `D:/ProtableGit/git-bash.exe` 文件。

显示一个类似 windows 命令行的东西。

第二行前面是一个 $ 符号 ,这个符号是命令提示符, 类似于 CAD 命令行的 命令: 。

首先设置您的 Git 用户名和邮箱

$ git config --global user.name "yourname"
$ git config --global user.email "you@qq.com"

      
现在,你可以从网络克隆 代码了

## 第二步 克隆

$ git clone https://gitee.com/atlisp/serivce.git

      
如果运行成功,会在 当前 目录下建立一个 `service` 目录 .


      正克隆到 'service'...
      remote: Enumerating objects: 18, done.
      remote: Counting objects: 100% (18/18), done.
      remote: Compressing objects: 100% (18/18), done.
      remote: Total 18 (delta 6), reused 0 (delta 0), pack-reused 0
      接收对象中: 100% (18/18), 8.63 KiB | 1.73 MiB/s, 完成.
      处理 delta 中: 100% (6/6), 完成.

## 第三步 开始您的工作
首先 进入这个目录,建立自己 的工作目录。yourname 是你在 gitee 上的帐户名,当然也可以是其它任何名字。


$ cd service
$ mkdir yourname

      
然后

$ ls

      
显示当前目录下的文件,应该会出现 `yourname` 这个目录。

我们在这个目录, 建立一个空文件 `first.lsp`

$ touch yourname/first.lsp

      
touch 是一个 linux 命令,功能是改变一个文件的修改访问时间。如果没有发现这个文件,会自动创建一个 名为 first.lsp 的空文件。

这个 touch 在这里只是一个示例,你 *不用* 每次操作都要 touch 一下。

现在我们查一下 当前的 git 状态。

$ git status

      
显示


      位于分支 main
      您的分支与上游分支 'origin/main' 一致。

      未跟踪的文件:
      (使用 "git add <文件>..." 以包含要提交的内容)
      ....
      yourname/

继续 , 我们将 yourname 加入到 git 本地仓库 临时暂存区,以便对 这个文件进行跟踪。

$ git add yourname

      
再查看一下 git 状态

$ git status

      
显示


      位于分支 main
      您的分支与上游分支 'origin/main' 一致。

      要提交的变更:
      (使用 "git restore --staged <文件>..." 以取消暂存)
      新文件:   yourname/first.lsp

      未跟踪的文件:
                (使用 "git add <文件>..." 以包含要提交的内容)
                ...

            

现在可以将这个目录提交到本地仓库。

$ git commit -m "加入目录 yourname"

               
提示


       加入目录 yourname
         1 file changed, 0 insertions(+), 0 deletions(-)
         create mode 100644 yourname/first.lsp

   
再查看一下 Git 状态

$ git status

      

      位于分支 main
      您的分支领先 'origin/main' 共 1 个提交。
          (使用 "git push" 来发布您的本地提交)

      未跟踪的文件:
         (使用 "git add <文件>..." 以包含要提交的内容)
      ....

## 第四步 推送你的成果
现在 你的本地仓库比远程仓库,多了一个提交。我们将 本地仓库 推送到 远程仓库中。

$ git push

      
按提示输入你在 Gitee 上的用户名和密码。

提示如下信息


      枚举对象中: 5, 完成.
      对象计数中: 100% (5/5), 完成.
      使用 4 个线程进行压缩
      压缩对象中: 100% (2/2), 完成.
      写入对象中: 100% (4/4), 336 字节 | 56.00 KiB/s, 完成.
      总共 4(差异 1),复用 0(差异 0),包复用 0
      remote: Powered by GITEE.COM
      To gitee.com:atlisp/service.git
            ead44e2..cfaee9bmain -> main

            
成功推送。现在打开浏览器 gitee 网站。 https://gitee.com/atlisp/service

就会在远程仓库中出现 yourname 这个目录,打开这个目录,出现 first.lsp 这个空文件。

## 第五步 继续工作,继续推送

从网络拉取最新内容

$ git pull

      
现在,试着用 编辑器编辑 你本地电脑上的这个 first.lsp 文件。完成保存后。
或者从其它目录复制一些文件到这个 目录 下。

在 Git 终端。输入


$ git add .
$ git commit -m "修改 yourname/first.lsp 或其它新增文件。"
$ git push

      
远程仓库会更新保存你的编辑内容。


## 第六步 Watching Starrd

在 Gitee https://getee.com/atlisp/service ,

右上角点 Watching 关注所有动态。 当这个仓库有改动时,会给您发提示信息。

点 Star 会将这个仓库 收藏到您的个人收藏里,方便您的查找。



spp_wall 发表于 2022-5-25 08:13:55

写了那么多不知道你这个最终要干什么呢,要达到什么目的?

vitalgg 发表于 2022-5-25 08:22:56

本帖最后由 vitalgg 于 2022-5-25 08:24 编辑

spp_wall 发表于 2022-5-25 08:13
写了那么多不知道你这个最终要干什么呢,要达到什么目的?
以上内容是 参与协同开发的基本技能。


@lisp 开源项目
https://gitee.com/atlisp



http://bbs.mjtd.com/data/attachment/forum/202205/24/103624c322pzpvmvwhmmry.png
http://bbs.mjtd.com/data/attachment/forum/202205/21/132744snp5tnzyuedn1u5n.png
http://bbs.mjtd.com/data/attachment/forum/202205/24/084401wgsv6i8xsqte8pnj.png

masterlong 发表于 2022-5-25 15:12:36

如果本身不是一个团队的话
很难协调这个共同开发

vitalgg 发表于 2022-5-25 15:37:31

本帖最后由 vitalgg 于 2022-5-25 15:41 编辑

masterlong 发表于 2022-5-25 15:12
如果本身不是一个团队的话
很难协调这个共同开发
不需要一个团队,各做各的项目就可以。

@lisp 只是把这些项目聚合在一起。 只需要按一个基本的标准开发就可以了。
这个标准非常简单,只要一个项目定义文件 pkg.lsp 就可以了。

有了这个文件,@lisp就可以从 您的项目仓库网址 下载到最终用户那里。
每个仓库是分布式的,不同的项目仓库可以在不同的托管平台。 github 、gitee 、gitlab、或自建的 git 服务器。

就像微信的各种小程序 。

gzsod 发表于 2022-5-26 16:33:14

看到有写支持浩辰中望CAD了要支持下
目前刚开始学

vitalgg 发表于 2022-5-29 17:10:19

@lisp 应用包开发说明

交互设计

* @lisp 菜单系统命令面板 短命令

* 配置管理
   配置开发方法

* 国际化与本地化
   i18n

一张单程票 发表于 2022-5-29 19:04:10

flowerson 发表于 2022-5-31 15:01:06

还不是很懂,先留个脚印。

SdlFreeCAD 发表于 2022-5-31 16:02:48

不生产lisp,只是lisp的搬运工. Anyway, 支持下.{:1_1:}
页: [1]
查看完整版本: @lisp 项目:开源协同开发 首次试水必读