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

vitalgg

原文地址： 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 用户名和邮箱

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

复制代码

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

## 第二步 克隆

1. $ 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 上的帐户名，当然也可以是其它任何名字。

1. 
   
2. $ cd service
   
3. $ mkdir yourname

复制代码

        
然后

1. $ ls

复制代码

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

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

1. $ touch yourname/first.lsp

复制代码

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

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

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

1. $ git status

复制代码

        
显示

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

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

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

1. $ git add yourname

复制代码

        
再查看一下 git 状态

1. $ git status

复制代码

        
显示

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

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

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

            

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

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

复制代码

               
提示

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

     
再查看一下 Git 状态

1. $ git status

复制代码

        

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

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

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

1. $ 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 [GNK-6.3]
        To gitee.com:atlisp/service.git
            ead44e2..cfaee9b  main -> main

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

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

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

从网络拉取最新内容

1. $ git pull

复制代码

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

在 Git 终端。输入

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

复制代码

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


## 第六步 Watching Starrd

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

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

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

spp_wall

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

vitalgg

spp_wall 发表于 2022-5-25 08:13
写了那么多  不知道你这个最终要干什么呢，要达到什么目的？

以上内容是 参与协同开发的基本技能。


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

masterlong

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

vitalgg

masterlong 发表于 2022-5-25 15:12
如果本身不是一个团队的话
很难协调这个共同开发

不需要一个团队，各做各的项目就可以。

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

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

就像微信的各种小程序 。

gzsod

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

vitalgg

@lisp 应用包开发说明

交互设计

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

* 配置管理
   配置开发方法

* 国际化与本地化
   i18n

一张单程票

flowerson

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

SdlFreeCAD

不生产lisp,只是lisp的搬运工. Anyway, 支持下.