{"id":19838885,"url":"https://github.com/supermap/idesktopx-maindocs","last_synced_at":"2025-02-28T19:15:21.389Z","repository":{"id":150182364,"uuid":"200955790","full_name":"SuperMap/iDesktopX-MainDocs","owner":"SuperMap","description":"存储SuperMap iDesktop Java 帮助文档内容。构建完整的SuperMap产品文档，请参见ReadMe说明。 ","archived":false,"fork":false,"pushed_at":"2019-09-24T08:43:02.000Z","size":37042,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-11T11:19:18.838Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SuperMap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"authors.yml","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-07T02:19:06.000Z","updated_at":"2020-03-13T01:51:55.000Z","dependencies_parsed_at":"2023-04-08T09:18:07.620Z","dependency_job_id":null,"html_url":"https://github.com/SuperMap/iDesktopX-MainDocs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuperMap%2FiDesktopX-MainDocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuperMap%2FiDesktopX-MainDocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuperMap%2FiDesktopX-MainDocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuperMap%2FiDesktopX-MainDocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SuperMap","download_url":"https://codeload.github.com/SuperMap/iDesktopX-MainDocs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241209528,"owners_count":19927734,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T12:19:27.702Z","updated_at":"2025-02-28T19:15:21.138Z","avatar_url":"https://github.com/SuperMap.png","language":"JavaScript","readme":"# 文件夹说明\n\n## content文件夹\n\n存放文档主要内容。[Products-Help-PublicContents](https://github.com/SuperMap/Products-Help-PublicContents)仓库中的所有内容，产品文档仓库中的所有内容，例如iDesktop Java的文档仓库[iDesktop-Java-MainDocs](https://github.com/SuperMap/iDesktop-Java-MainDocs)都需要拷贝到此文件夹下。\n\n## src文件夹\n\n存放页面相关的风格样式文件。\n\n### locale文件夹\n\nsrc/locale 文件夹中存放的是产品的本地化资源，本地化资源各个产品不完全相同。为便于产品维护，在产品文档仓库中也放置了src/locale文件夹，存放产品的本地化资源。使用时，直接剪贴locale文件夹中的内容。\n\n# 如何使用\n\n将所有文件夹，直接拷贝到content文件夹下。content文件夹，需要从[Products-Help-MainFrame](https://github.com/SuperMap/Products-Help-MainFrame \"文档主框架\")仓库下载。\n\n一个完整的产品帮助文档，由以下三个仓库的内容组成：\n- Products-Help-MainFrame \n- Products-Help-PublicContents\n- 产品文档仓库内容：命名规则：产品名称-MainDocs\n\n其中，Products-Help-PublicContents仓库中的所有内容，产品文档仓库中的所有内容，都需要拷贝到Products-Help-MainFrame仓库中的content文件夹下。\n\n# 如何编译文档\n\n## 需要的环境\n\n### Node.js\n\nNode.js的安装与配置，请参照Node.js的官网https://nodejs.org/en/\n\n### Yarn\n\nYarn的安装，可参照https://www.yarnpkg.com/zh-Hans/\n\n### 命令行安装Gatsby开发环境\n\nnpm install -g gatsby-cli  全局安装（不用进入项目目录）\n\n### 本地编译\n\n如果是首次从Github仓库中下载源码文件，则需要为其安装依赖。打开cmd，路径跳转到源码目录下：\n\n1. 执行 **yarn** 或**yarn install** 安装全部依赖。\n\n2. 执行**yarn dev -p 端口号**。\n\nyarn dev 命令是开发环境下编译本地文件。\n注意：dev 开发环境时，需要注释掉src/components/Layout/layout.js中build生产环境的代码：\n` locationPath = locationPath.substring(locationPath.replace('/', 'a').indexOf('/'), locationPath.length); `\n使用 gatsby build 命令时，需要取消注释。\n\n3. 本地浏览器中，输入 **localhost:端口号**，访问在线文档。\n\n## 配置产品名称\n\n需要配置产品名称，修改 gatsby-config.js 中的代码：\n\n` pathPrefix: /****, `\n\n# 如何发布文档\n\n1. 本地调试：gatsby build --prefix-paths\n2. 本地发布：gatsby serve --prefix-paths\n3. 在本地调试发布的内容无误后，可以使用Tomcat对文档内容进行发布。 \n使用Tomcat发布，需将编译生成的public文件，拷贝到webapps文件夹下，并将public文件夹名称修改为对应的产品名称。\n\n# License\nContent submitted to [reactjs.org](https://reactjs.org/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/open-source-explorer/reactjs.org/blob/master/LICENSE-DOCS.md) file.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupermap%2Fidesktopx-maindocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupermap%2Fidesktopx-maindocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupermap%2Fidesktopx-maindocs/lists"}