乔治·吉拉夫
GeoGirafe是构建在线地理学门户的灵活应用. 此寄存器包含工程的网页查看器部分 .
项目文件见这里: https://doc.geogirafe.org 互联网档案馆的存檔,存档日期2013-12-02。 。 。 .
GeoGirafe 的演示实例可在此测试: https://demo.geomapfish.dev. 中国植物物种信息数据库。 。 。 .
目标
GeoGirafe的目标是便于实施稳定、高效和安全的地理门户。 GeoGirafe也是为了便于扩展,允许用户整合自己的插件.
由于GeoGirafe的主要用户不一定具备计算机开发的高级技能,我们希望有一个尽可能平滑的学习曲线. 这就是为什么该项目不使用最新的框架,偏好可读代码而不是符合某些任意"质量"标准的代码. GeoGirafe因此基于网络标准(Vanilla Web组件),并将依赖性的数量限制在其他图书馆.
发展哲学
GeoGirafe是根据以下原则开发的:
-
儿童状况:GeoGirafe很简单. 由纯瓦尼拉-贾瓦斯克丽普特开发. 没有使用React或Angular等复杂的框架. 如果你知道JavaScript,你可以理解它是如何工作的.
-
函数:GeoGirafe在软件生命周期的每个阶段都烘焙安全,以便交付安全逐一设计的应用程序. 索纳克卢德平台在不断整合的过程中检查质量、可读性、可靠性和安全性: 查看声纳云报告
-
反应: GeoGirafe 意在按照 反应宣言。 。 。 .
-
敏捷性:GeoGirafe正在按照Agile方法开发。 我们珍视个人合作,改变反应能力多于进程、工具和计划.
-
无障碍GeoGirafe正在尽其所能,使残疾人更容易获得网页内容: 查看波浪报告。 。 。 .
建筑
以下详细解释GeoGirafe项目的建筑选择,包括战略目标和技术选择: https://doc.geogirafe.org/docs/introduction/architecture 页面存档备份,存于互联网档案馆。 。 。 .
开始
若你想从GeoGirafe开始 https://hub.docker.com/r/geogirafe/viewer 互联网档案馆的存檔,存档日期2014-12-02。 。 。 . 这将允许你得到一个运行的例子 GeoGirafe 用最小的努力. 请跟随"多克·赫克·雷克"中的小文档.
与GeoGirafe合作
发展
1. 克隆库
首先,安装 节点。 。 。 .
然后,复制仓库:
git clone https://gitlab.com/geogirafe/gg-viewer.git
2. 发展证书
某些特征(如服务人员)需要有效的HTTPS证书,才能在当地得到发展.
您可以以 :
在 Linux 上
在 Linux 或 macOS 上,生成您自己的证书是强制性的(预生成的证书不会工作).
npm run generate-dev-certs-nix
在窗口上
npm run generate-dev-certs-win
3. 建造和启动GeoGirafe
npm install
npm start
当在当地工作 认证, 更普遍与饼干, 浏览器将单标签域(没有任何点的域)与多标签域(至少有一个点的域)区别对待. 在单一标签域上设置的饼干往往被认为不太安全,因为它们更容易被偷取或被滥用。 因此,许多浏览器限制或不允许将 cookie 设定在像
localhost。 。 。 .因此,反对https://localhost 将不工作,因为饼干无法正确设置.
你必须用 https://app.localhost (英语),这在本地与GeoGirafe合作时被定义为默认域.
进一步讨论:
- https://stackoverflow.com/ questions/7346919.chrome-localhost-cookie-not-ain-set 页面存档备份,存于互联网档案馆
- https://stackoverflow.com/ questions/1134290/cookies-on-localhost- with-explict-domain (中文(中国大陆) )
使用 VSCode 调试
如果您正在使用 VSCode , 则在 .vscode 目录.
在您在开发模式下启动应用程序后, 请按 F5, VSCode 将附加在运行过程中。 然后您就可以调试您的代码 .
配置
应用程序的完整配置在文件中完成 config.json。 。 。 .
此配置将在应用程序启动时被动态加载 .
因此,在修改此文件时不需要重建工程 .
文件 config.json 默认不存在.
最简单的创建方式是,在 演示 目录,并调整内容以适应您的需要.
您也可以通过使用 :
在 Linux 上
npm run configure-demo <environment>
在窗口上
npm run configure-demo-win <environment>
这将自动复制 config.json ,并下载所需的 Moock 对象.
请注意,GeoGirafe Viewer目前使用基于GeoMapFish的后端. 因此,您在配置中使用的服务必须符合GeoMapFish.
测试
GeoGirafe项目有两种测试:
单位数( 有vitest)
要运行单元, 请执行以下命令 :
npm run test
且道.
端到端测试( 有剧作家)
为了能够进行剧作家测试,首先安装了无头铬和火狐二进制:
npx playwright install
您必须启动应用程序 :
npm start
然后在另一个控制台 你可以运行测试:
npx playwright test
结果页会在测试结束时预示.
生产建筑
npm install
npm run build
这将输出一个完整的 GeoGirafe 应用程序, 可用 Web 服务器服务 很简单 备忘/应用 文件夹.
您可以尝试已建资产( 您需要此示例 ) :
docker run --rm -p 8088:80 -v $(pwd)/dist/app:/usr/share/nginx/html nginx:latest
这将旋转一个NGINX 你可以访问它 app.localhost:8088 (英语)。 。 。 .
新闻 CTRL+C 拦住集装箱.
建立国家预防机制一揽子计划
一定要运行命令 npm login 至少在一次之前
构建库
npm install
npm run build-lib
这将输出( 除其它部分外) GeoGirafe 库部分的转录版本 点/点。 。 。 .
发布 Lib 软件包 npmjs.com (英语)
npm run publish-lib --access public
构建 Android 应用程序
确定您之前已经构建了生产应用程序 npm run build。 。 。 .
文件 config.json 包含在 dist\app 将使用目录.
npm run build-apk
这将输出一个 GeoGirafe 的 APK 软件包 磁盘/磁盘。 。 。 .
部署
部署可采取两种方式:
使用已存在的 WebServer 服务器
建成后,所有需要部署的都放在 public 目录.
复制 public 任意网络服务器的目录内容,例如 htdocs 目录.
使用嵌入器
当工程建成后,您可以构建一个会包含应用程序的嵌入器图像:
docker build -t <your_name>/viewer -f buildtools/Dockerfile dist
然后,你可以开始:
docker run -p 8080:80 -p 8443:443 <your_name>/viewer
捐款
欢迎合并请求.
对于重大变动,请先开出一个问题来讨论你想要改变什么.
此处提供捐款准则: 捐款额。 。 。 .
请在投稿前读一下.
支助
支持GeoGirafe的方法很多.
-
您可以在您的项目上使用以下标签来帮助推广 GeoGirafe :
代码 :[](https://geogirafe.org) -
如果你有兴趣提供财政援助,请联系我们 联系人@geogirafe.org。 。 。 .
-
如果你有另一个想法 如何支持这个项目, 我们邀请你加入我们 在专有的不和服务器: https://discord.gg/kdrXjaqBbH 页面存档备份,存于互联网档案馆。 。 。 .
许可证
Apache 许可证,2.0版本