├── .editorconfig.txt ├── .gitignore ├── 404.html ├── CNAME ├── Gemfile ├── Gemfile.lock ├── LICENSE ├── README.md ├── _config.yml ├── _data └── docs.yml ├── _docs ├── AppImageHub.md ├── Creating_AppImages.md ├── appimage.md ├── appimage_usage.md ├── appimaged_usage.md ├── appimagetool_usage.md ├── index.md ├── linuxdeployqt.md ├── pkg2appimage.md └── wiki.md ├── _includes ├── docs_nav.html ├── footer.html ├── head.html ├── js_files.html ├── section_nav.html └── topnav.html ├── _layouts ├── default.html └── docs.html ├── _sass ├── _bootstrap.scss ├── _syntax-highlighting.scss ├── _typeahead.scss ├── bootstrap │ ├── _alerts.scss │ ├── _badges.scss │ ├── _breadcrumbs.scss │ ├── _button-groups.scss │ ├── _buttons.scss │ ├── _carousel.scss │ ├── _close.scss │ ├── _code.scss │ ├── _component-animations.scss │ ├── _dropdowns.scss │ ├── _forms.scss │ ├── _glyphicons.scss │ ├── _grid.scss │ ├── _input-groups.scss │ ├── _jumbotron.scss │ ├── _labels.scss │ ├── _list-group.scss │ ├── _media.scss │ ├── _mixins.scss │ ├── _modals.scss │ ├── _navbar.scss │ ├── _navs.scss │ ├── _normalize.scss │ ├── _pager.scss │ ├── _pagination.scss │ ├── _panels.scss │ ├── _popovers.scss │ ├── _print.scss │ ├── _progress-bars.scss │ ├── _responsive-embed.scss │ ├── _responsive-utilities.scss │ ├── _scaffolding.scss │ ├── _tables.scss │ ├── _theme.scss │ ├── _thumbnails.scss │ ├── _tooltip.scss │ ├── _type.scss │ ├── _utilities.scss │ ├── _variables.scss │ ├── _wells.scss │ └── mixins │ │ ├── _alerts.scss │ │ ├── _background-variant.scss │ │ ├── _border-radius.scss │ │ ├── _buttons.scss │ │ ├── _center-block.scss │ │ ├── _clearfix.scss │ │ ├── _forms.scss │ │ ├── _gradients.scss │ │ ├── _grid-framework.scss │ │ ├── _grid.scss │ │ ├── _hide-text.scss │ │ ├── _image.scss │ │ ├── _labels.scss │ │ ├── _list-group.scss │ │ ├── _nav-divider.scss │ │ ├── _nav-vertical-align.scss │ │ ├── _opacity.scss │ │ ├── _pagination.scss │ │ ├── _panels.scss │ │ ├── _progress-bar.scss │ │ ├── _reset-filter.scss │ │ ├── _reset-text.scss │ │ ├── _resize.scss │ │ ├── _responsive-visibility.scss │ │ ├── _size.scss │ │ ├── _tab-focus.scss │ │ ├── _table-row.scss │ │ ├── _text-emphasis.scss │ │ ├── _text-overflow.scss │ │ └── _vendor-prefixes.scss └── bootswatch │ ├── LICENSE │ ├── cerulean │ ├── _bootswatch.scss │ └── _variables.scss │ ├── cosmo │ ├── _bootswatch.scss │ └── _variables.scss │ ├── custom │ ├── _bootswatch.scss │ └── _variables.scss │ ├── cyborg │ ├── _bootswatch.scss │ └── _variables.scss │ ├── darkly │ ├── _bootswatch.scss │ └── _variables.scss │ ├── flatly │ ├── _bootswatch.scss │ └── _variables.scss │ ├── journal │ ├── _bootswatch.scss │ └── _variables.scss │ ├── lumen │ ├── _bootswatch.scss │ └── _variables.scss │ ├── paper │ ├── _bootswatch.scss │ └── _variables.scss │ ├── readable │ ├── _bootswatch.scss │ └── _variables.scss │ ├── sandstone │ ├── _bootswatch.scss │ └── _variables.scss │ ├── simplex │ ├── _bootswatch.scss │ └── _variables.scss │ ├── slate │ ├── _bootswatch.scss │ └── _variables.scss │ ├── solar │ ├── _bootswatch.scss │ └── _variables.scss │ ├── spacelab │ ├── _bootswatch.scss │ └── _variables.scss │ ├── superhero │ ├── _bootswatch.scss │ └── _variables.scss │ ├── united │ ├── _bootswatch.scss │ └── _variables.scss │ └── yeti │ ├── _bootswatch.scss │ └── _variables.scss ├── css ├── font-awesome.min.css └── main.scss ├── favicon.ico ├── fonts ├── FontAwesome.otf ├── fontawesome-webfont.eot ├── fontawesome-webfont.svg ├── fontawesome-webfont.ttf ├── fontawesome-webfont.woff └── fontawesome-webfont.woff2 ├── img ├── bg.jpg ├── jekyll-dark.png ├── jekyll.png └── logonav.png ├── index.html ├── js ├── bootstrap.min.js ├── main.js └── typeahead.bundle.min.js └── search.json /.editorconfig.txt: -------------------------------------------------------------------------------- 1 | # http://editorconfig.org 2 | root = true 3 | 4 | [*] 5 | charset = utf-8 6 | end_of_line = lf 7 | indent_size = 2 8 | indent_style = space 9 | insert_final_newline = true 10 | max_line_length = 80 11 | trim_trailing_whitespace = true 12 | 13 | [*.md] 14 | max_line_length = 0 15 | trim_trailing_whitespace = false 16 | 17 | [COMMIT_EDITMSG] 18 | max_line_length = 0 19 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | _site 2 | .sass-cache 3 | .jekyll-metadata 4 | *.gem 5 | .bundle 6 | vendor/bundle 7 | -------------------------------------------------------------------------------- /404.html: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | --- 4 | 5 |
6 |

The page you are looking for cannot be found.

7 |

404

8 |
9 | -------------------------------------------------------------------------------- /CNAME: -------------------------------------------------------------------------------- 1 | doc.appimage.cn -------------------------------------------------------------------------------- /Gemfile: -------------------------------------------------------------------------------- 1 | source "https://rubygems.org" 2 | ruby RUBY_VERSION 3 | 4 | gem "jekyll", "3.4.3" 5 | 6 | # to use GitHub Pages 7 | # gem "github-pages", group: :jekyll_plugins 8 | 9 | # If you have any plugins, put them here! 10 | group :jekyll_plugins do 11 | gem "jekyll-feed" 12 | gem "jekyll-sitemap" 13 | gem "jekyll-redirect-from" 14 | gem "jekyll-seo-tag" 15 | end 16 | 17 | # Windows does not include zoneinfo files, so bundle the tzinfo-data gem 18 | gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw, :jruby] 19 | -------------------------------------------------------------------------------- /Gemfile.lock: -------------------------------------------------------------------------------- 1 | GEM 2 | remote: https://rubygems.org/ 3 | specs: 4 | addressable (2.5.1) 5 | public_suffix (~> 2.0, >= 2.0.2) 6 | colorator (1.1.0) 7 | ffi (1.9.18) 8 | forwardable-extended (2.6.0) 9 | jekyll (3.4.3) 10 | addressable (~> 2.4) 11 | colorator (~> 1.0) 12 | jekyll-sass-converter (~> 1.0) 13 | jekyll-watch (~> 1.1) 14 | kramdown (~> 1.3) 15 | liquid (~> 3.0) 16 | mercenary (~> 0.3.3) 17 | pathutil (~> 0.9) 18 | rouge (~> 1.7) 19 | safe_yaml (~> 1.0) 20 | jekyll-feed (0.9.2) 21 | jekyll (~> 3.3) 22 | jekyll-redirect-from (0.12.1) 23 | jekyll (~> 3.3) 24 | jekyll-sass-converter (1.5.0) 25 | sass (~> 3.4) 26 | jekyll-seo-tag (2.2.2) 27 | jekyll (~> 3.3) 28 | jekyll-sitemap (1.1.1) 29 | jekyll (~> 3.3) 30 | jekyll-watch (1.5.0) 31 | listen (~> 3.0, < 3.1) 32 | kramdown (1.13.2) 33 | liquid (3.0.6) 34 | listen (3.0.8) 35 | rb-fsevent (~> 0.9, >= 0.9.4) 36 | rb-inotify (~> 0.9, >= 0.9.7) 37 | mercenary (0.3.6) 38 | pathutil (0.14.0) 39 | forwardable-extended (~> 2.6) 40 | public_suffix (2.0.5) 41 | rb-fsevent (0.9.8) 42 | rb-inotify (0.9.8) 43 | ffi (>= 0.5.0) 44 | rouge (1.11.1) 45 | safe_yaml (1.0.4) 46 | sass (3.4.23) 47 | 48 | PLATFORMS 49 | ruby 50 | 51 | DEPENDENCIES 52 | jekyll (= 3.4.3) 53 | jekyll-feed 54 | jekyll-redirect-from 55 | jekyll-seo-tag 56 | jekyll-sitemap 57 | tzinfo-data 58 | 59 | RUBY VERSION 60 | ruby 2.3.3p222 61 | 62 | BUNDLED WITH 63 | 1.16.1 64 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2017 Gamuxorg 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # AppImage-CN 2 | AppImage中文文档，源自官方英文文档。官方团队将源文档进行了粗略的Google机翻，[Gamux社区](https://www.linuxgame.cn)和[AppImage中文社区](https://appimage.cn/)（实际是一拨人）进行校对和整理。目前文档还在整理中。 3 | 4 | ## 加入翻译的方法 5 | 1. pull requests 6 | 2. 提交issues提示翻译组 7 | 3. 加入QQ群274328087（拥有push权限）或IRC上FreeNode服务器的#appimage-zh频道或Telegram上的gamux-zh频道找管理员鸡君申请team remember资格。 8 | 9 | ## AppImage社区 10 | 1. (官方英文)IRC的Freenode服务器的#appimage频道/(非官方中文) 11 | 2. [官方AppImage论坛](https://discourse.appimage.org/) 12 | 3. [中文AppImage论坛](https://bbs.appimage.cn/) 13 | 14 | ## 文本协议 15 | 文档内容使用MIT协议发布。 16 | -------------------------------------------------------------------------------- /_config.yml: -------------------------------------------------------------------------------- 1 | # Site settings 2 | encoding: utf-8 3 | title: AppImage中文文档 4 | email: 345865759@163.com 5 | description: > 6 | AppImage中文文档，基于jekyll-doc-theme模板修改。 7 | 8 | baseurl: # the subpath of your site, e.g. /blog/ 9 | url: http://doc.appimage.cn # the base hostname & protocol for your site 10 | git_address: https://github.com/Gamuxorg/AppImages 11 | git_edit_address: https://github.com/Gamuxorg/AppImage-CN/tree/master 12 | 13 | # theme options from https://bootswatch.com/ 14 | # comment out this to use default Bootstrap 15 | bootwatch: paper 16 | 17 | # Build settings 18 | markdown: kramdown 19 | highlighter: rouge 20 | gems: 21 | - jekyll-feed 22 | - jekyll-redirect-from 23 | - jekyll-seo-tag 24 | - jekyll-sitemap 25 | 26 | exclude: 27 | - Gemfile 28 | - Gemfile.lock 29 | - .idea/ 30 | - .gitignore 31 | - README.md 32 | timezone: Asia/Shanghai 33 | defaults: 34 | - scope: 35 | path: _docs 36 | type: docs 37 | values: 38 | layout: docs 39 | sectionid: docs 40 | seo: 41 | type: "WebPage" 42 | 43 | collections: 44 | docs: 45 | permalink: /:collection/:path/ 46 | output: true 47 | -------------------------------------------------------------------------------- /_data/docs.yml: -------------------------------------------------------------------------------- 1 | - title: 初识AppImage 2 | docs: 3 | - home 4 | - appimage 5 | - appimage-usage 6 | - creating-appimages 7 | - pkg2appimage 8 | - appimagetool-usage 9 | - appimaged-usage 10 | - appimagehub 11 | - linuxdeployqt 12 | - wiki 13 | 14 | - title: Examples 15 | docs: 16 | - cheatsheet 17 | - font-awesome 18 | - bootstrap 19 | -------------------------------------------------------------------------------- /_docs/AppImageHub.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: AppImageHub 3 | permalink: /docs/appimagehub/ 4 | --- 5 | 6 | ### AppImageHub 7 | 8 | https://appimage.github.io/ 9 | 10 | #### 这是... 11 | 12 | * __可用的，经过审查的 AppImages 的众包目录__ ，包含第三方应用商店和软件中心可以使用的数据。给定一个 AppImage 的 URL，它检查 AppImage 并将其放入社区维护的目录中。这个想法是，所有的元数据都在 AppImage 中传播，所以只要向这个仓库添加一个 URL 就行了，其它的都包含在 AppImage 自身。 13 | 14 | #### 这不是... 15 | 16 | * __appimage分发渠道__ 。 AppImageHub __不分发AppImages__或提供下载。它只是链接到各自作者的下载页面，从那里用户将能够下载AppImages。它也__不跟踪版本__，仅仅是诸如“release”、“beta”，“nightly”，“continuous”（由上游应用程序作者定义）等各种 channels。我们认为，试图跟踪中央存储库中的所有版本是徒劳的，因为它不能扩展。 17 | 18 | #### 用户故事 19 | 20 | * “作为一个用户，我想有一个可用的AppImage的中央目录，我可以直接从应用程序作者那里下载，以便我知道什么是可用的。” 21 | * “作为一名开发人员，我希望尽可能多地向我的用户提供我的应用程序，以便增加我的用户群。” 22 | * “作为应用中心或应用商店开发者，我希望能够轻松获得关于可用 AppImages 的信息，以便我可以专注于构建我的应用中心或应用商店，而不必自己抓取 Internet 上的 AppImages。 23 | 24 | #### 如何将 AppImages 提交到目录 25 | 26 | 通过 [此链接](https://github.com/AppImage/AppImageHub/new/gh-pages/data) 创建一个新文件并发送合并请求。该文件应该包含一个超链接指向其 Github 仓库存放 AppImage 的 Release 页面，或者一个指向 AppImage 的链接，就这么简单就行了。然后发送一个合并请求到这个仓库。 Travis CI 将立即执行 AppImage 的自动检查，如果成功，您将在您的请求中看到 __绿色的__ 结果。如果您得到 __红色的__ 结果，请检查Travis CI构建的日志，并修复它。 27 | 28 | #### 提交您自己的 AppImage 的清单 29 | 30 | 作为一种格式，AppImage 并不会对生成 AppImages 的人施加限制。基本上，你想往 AppImage 里面放什么都可以。但是，对于 AppImageHub，还是需要附加规则的。提交给 AppImage 中心的 AppImages 会自动进行也可能手动审查。 31 | 32 | * 必须能通过 URL 下载。我们的测试系统使用 `wget` 获取 AppImage。目前，我们无法从一个有身份验证或Cookie保护的位置获取 AppImages。对于商业应用，我们建议有一个通用可下载的演示/试用版本。如果您想将您的商业AppImage添加到目录中，而这个软件并且无法进行常规下载，请联系我们 33 | * 必须能运行在 [仍受支持的最旧 Ubuntu LTS 版本](https://www.ubuntu.com/info/release-end-of-life) （目前是Ubuntu 14.04）上，而不需要安装额外的软件包。这是为了确保AppImage不仅可以在最新版本上运行，而且还可以在较旧的目标系统上运行，比如企业版（不限于Ubuntu） 34 | * 必须能在我们的基于 Travis CI 的测试环境中执行 35 | * 必须通过 [appdir-lint.sh](https://github.com/AppImage/AppImages/blob/master/appdir-lint.sh) 36 | * 必须有一个通过 `desktop-file-validate` 的 desktop 文件 37 | * 必须可以运行在无有效的互联网连接的环境下（还有至少要显示一些信息） 38 | * 在`usr/share/metainfo`中应该有一个 [AppStream元信息文件](https://people.freedesktop.org/~hughsient/appdata/)。而且必须通过 `appstreamcli` 验证 39 | * 应该显示一个有用的界面，而不是一些粗略的对话框，因为主窗口将用于主屏幕截图。您还可以使用 [AppStream元信息文件](https://people.freedesktop.org/~hughsient/appdata/) 提供自己的屏幕截图 40 | * 不包含版本号的固定 URL 也必须可用。GitHub Release 或者 `openSUSE Build Service` 是满足要求的（你可以自由地选择推荐以外的其他服务） 41 | 42 | #### 如何使用 43 | 44 | 应用程序商店和软件中心可以使用此项目收集的元数据。请参阅 [AppImage生态系统](https://github.com/AppImage/AppImageKit/wiki/Ecosystem)。 45 | 46 | 目前我们正在 https://appimage.github.io/feed.json 上提供一个JSON提要。如果您想使用这些数据则需要更改，请通过i rc.freenode.net上 的 #AppImage 与我们联系，以便我们可以讨论最适合您需求的输出格式。 __请注意__，Release之前，数据输出格式尚未最终确定，如有更改，恕不另行通知。 47 | -------------------------------------------------------------------------------- /_docs/appimage.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 什么是AppImage？ 3 | permalink: /docs/appimage/ 4 | --- 5 | 6 | 7 | ### 什么是AppImage？ 8 | 9 | __AppImage__ 是一种把应用打包成单一文件的格式，允许在各种不同的目标系统（基础系统(Debian、RHEL等)，发行版(Ubuntu、Deepin等)）上运行，无需进一步修改。 10 | 11 | https://en.wikipedia.org/wiki/AppImage 12 | 13 | __AppImageKit__ 是AppImage的构建工具包，提供了`appimagetool`和`appimaged`等工具来方便地处理AppImage。 14 | 15 | `appimagetool`将AppDir目录转换成自挂载的文件系统镜像。 `appimaged`是一个守护进程，用于处理AppImage与系统（菜单条目，图标，MIME类型，二进制增量更新等）的注册或注销。 16 | 17 | 提供[AppImage](http://appimage.org/)格式的包用于分发应用相对于其他格式，具有以下优点： 18 | - 使用AppImage打包的应用程序可以在许多发行版上运行（包括Ubuntu，Fedora，openSUSE，CentOS，basicOS，Linux Mint等） 19 | - 一个应用程序 = 一个文件 = 对用户超级简单：只需下载一个AppImage文件，[使其可执行](http://discourse.appimage.org/t/how-to-make-an-appimage-executable/80) ，然后运行 20 | - 不需要解压或安装 21 | - 不需要root权限（通常在Debian及其衍生版你需要sudo apt install来安装软件并需要输入密码） 22 | - 不会改变系统的依赖库 23 | - 开箱即用，无需安装运行库（使用snap和flatpak却需要） 24 | - 可选的`appimaged`桌面集成功能（注册快捷方式等） 25 | - 可以二进制增量更新，例如，用于连续构建（仅下载二进制比较）的AppImageUpdate工具 26 | - 可以使用GPG2 - （在文件内）签署你的AppImage应用 27 | - 在Live ISOs上运行 28 | - 系统安装多个发行版时可以使用相同的AppImage应用 29 | - 可以在AppImage的应用中心[AppImageHub](https://appimage.github.io/apps)发布和下载应用 30 | - 可以使用“--appimage-extract”参数来自解压应用，例如 31 | ``` 32 | ./typora.AppImage --appimage-extract 33 | ``` 34 | 35 | 这里是官方上游已分发的AppImage格式应用的[概览](https://appimage.github.io/apps)。 36 | 37 | 如果您有任何问题，请到irc.freenode.net上的#AppImage频道进行询问。 38 | -------------------------------------------------------------------------------- /_docs/appimage_usage.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: AppImage的使用方法 3 | permalink: /docs/appimage-usage/ 4 | --- 5 | 6 | ### AppImage的使用方法 7 | 8 | 9 | 10 | 运行一个AppImage将会挂载文件系统镜像，并透明地运行包含的应用程序。所以AppImage的使用通常应该等于它包含的应用程序的使用。但是，如本文所说，他还有其他特殊功能。如果你收到的AppImgae不支持这些选项，请让AppImage的作者使用最新的`appimagetool`（或`linuxdeployqt`）重新构建。 11 | 12 | #### 命令行参数 13 | 14 | 如果你运行一个由较新AppImageKit构建的AppImage并附加以下参数之一，那么AppImage的行为将有所不同： 15 | 16 | - `--appimage-help` 显示帮助选项 17 | - `--appimage-offset` 显示文件系统镜像开始的偏移量，然后退出。如果你想使用`mount -o loop，offset=...` 命令来循环挂载文件系统镜像，这很有用 18 | - `--appimage-extract` 从文件系统镜像中提取内容，然后退出。如果你在不支持FUSE的系统上使用AppImage，这非常有用 19 | - `--appimage-mount` 挂载嵌入式文件系统镜像并打印挂载地址，然后等待直到结束。如果你想检查AppImage的内容而不执行包含的应用程序内容，这非常有用 20 | - `--appimage-version` 显示AppImageKit的版本，然后退出。当你需要提问的时候，这很有用 21 | - `--appimage-updateinformation` 显示AppImage中的更新信息，然后退出。这对调试增量更新非常有用 22 | - `--appimage-signature` 显示AppImage中的数字签名，然后退出。这对调试增量更新非常有用。如果你想验证此签名，则应使用AppImageKit的另一所属命令行工具 `validate` 23 | 24 | #### 特殊的目录 25 | 26 | 通常情况下，包含在AppImage中的应用程序将存储它的配置文件，无论它通常存储在哪里（最常见的是在$HOME中的某处）。如果你运行由较新AppImageKit构建的AppImage，并且存在以下特殊目录之一，那么配置文件将与AppImage一起存储。这对于便携式使用情况是有用的，例如，在U盘上携带AppImage以及其数据。 27 | 28 | - 如果有一个和AppImage文件同名的目录名且加`.home`，那么在执行应用程序之前，会自动将$HOME设置为它 29 | - 如果有一个和AppImage文件同名的目录名且加`.config`，那么在执行应用程序之前，会自动将$XDG_CONFIG_HOME设置为它 -------------------------------------------------------------------------------- /_docs/appimaged_usage.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: appimaged用法 3 | permalink: /docs/appimaged-usage/ 4 | --- 5 | 6 | ### appimaged用法 7 | 8 | `appimaged`是一个可选的守护进程，用于监视AppImages的像`~/bin`和`~/Downloads`的位置，如果检测到某些守护进程，则将其注册到系统中，以便它们显示在菜单中，将它们的图标显示出来，关联MIME类型等等。如果它们被删除，它也从系统中再次注销AppImages。如果安装了[firejail](https://github.com/netblue30/firejail)，则会一同运行AppImage。 9 | 10 | 预编译版本可以在上次成功的Travis CI版本中找到，您可以通过以下方式获得： 11 | 12 | ``` 13 | wget "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimaged-x86_64.AppImage" 14 | chmod a+x appimaged-x86_64.AppImage 15 | ``` 16 | 17 | 用法简而言之： 18 | 19 | ``` 20 | ./appimaged-x86_64.AppImage --install 21 | ``` 22 | 23 | 或者，如果您使用的是基于deb包管理的系统： 24 | 25 | ``` 26 | wget -c "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimaged_1.0_amd64.deb" 27 | sudo dpkg -i appimaged_*.deb 28 | systemctl --user enable appimaged 29 | systemctl --user start appimaged 30 | ``` 31 | 32 | 它将从以下位置在您的系统中注册AppImages： 33 | * $HOME/Downloads 34 | * $HOME/.local/bin 35 | * $HOME/bin 36 | * /Applications 37 | * /isodevice/Applications 38 | * /isofrom/Applications 39 | * /run/archiso/img_dev/Applications 40 | * /opt 41 | * /usr/local/bin 42 | 43 | 运行`appimaged -v`来输出详细信息。 44 | 45 | 详细用法： 46 | ``` 47 | 用法： 48 |   appimaged [选项...] 49 | 50 | 帮助选项： 51 |   -h,--help 显示帮助选项 52 | 53 | 应用选项： 54 |   -v,--verbose 输出详细信息 55 |   -i,--install 将这个appimaged实例安装到$HOME 56 |   -u,--uninstall 从$HOME中卸载一个appimaged实例 57 |   --version 显示版本号 58 | 59 | ``` 60 | 61 | __注意：__ 可能需要重新启动（或者`xkill`）dash命令行，nautilus，来识别第一次运行`appimaged`之前不存在的新目录。另外，在appimaged运行一次后应该注销并重新登录。 62 | 63 | 如果你的`$PATH`上有`AppImageUpdate`，那么它也可以做到这一点： 64 | 65 | ![截图从2016-10-15 16-37-05](https://cloud.githubusercontent.com/assets/2480569/19410850/0390fe9c-92f6-11e6-9882-3ca6d360a190.jpg) 66 | 67 | 从 https://github.com/AppImage/AppImageUpdate/releases/download/continuous/ 上下载AppImageUpdate 并放在你的`$ PATH`上： 68 | 69 | ``` 70 | sudo mv "Downloads/AppImageUpdate-*.AppImage" /usr/local/bin/AppImageUpdate 71 | chmod a+x /usr/local/bin/AppImageUpdate 72 | ``` 73 | -------------------------------------------------------------------------------- /_docs/appimagetool_usage.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: appimagetool的使用方法 3 | permalink: /docs/appimagetool-usage/ 4 | --- 5 | 6 | ### appimagetool的使用方法 7 | 8 | `appimagetool`用于把现有的`AppDir`(目录)生成一个AppImage。一些更高级别的工具，如[`linuxdeployqt`](https://github.com/probonopd/linuxdeployqt)等也在使用它。预编译版本可以在[GitHub Releases](https://github.com/AppImage/AppImageKit/releases)上找到。 9 | 10 | ``` 11 | wget "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage" 12 | chmod a+x appimagetool-x86_64.AppImage 13 | ``` 14 | 15 | 简而言之，假设你已经有一个[AppDir](https://github.com/AppImage/AppImageSpec/blob/master/draft.md#appdir) ： 16 | 17 | ``` 18 | ./appimagetool-x86_64.AppImage some.AppDir 19 | ``` 20 | 21 | 详细用法： 22 | ``` 23 | 用法： 24 |   appimagetool [OPTION ...] SOURCE [DESTINATION] - 生成，提取和检查AppImages 25 | 26 | 帮助选项： 27 |   -h，--help 显示帮助选项 28 | 29 | 应用选项： 30 |   -l, --list 列出SOURCE AppImage中的文件 31 |   -u, --updateinformation 嵌入更新信息STRING; 如果安装了 zsyncmake，则生成 zsync 文件 32 |   --bintray-user Bintray用户名 33 |   --bintray-repo Bintray存储库 34 |   --version 显示版本号 35 |   -v, --verbose 产生详细的输出 36 | -s, --sign 用 gpg2 签名 37 | -n, --no-appstream 不检查AppStream元数据 38 | ``` 39 | 40 | 如果你想手动生成一个AppImage，你可以： 41 | 42 | ``` 43 | mksquashfs Your.AppDir Your.squashfs -root-owned -noappend 44 | cat runtime >> Your.AppImage 45 | cat Your.squashfs >> Your.AppImage 46 | chmod a+x Your.AppImage 47 | ``` 48 | -------------------------------------------------------------------------------- /_docs/index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 起始 3 | permalink: /docs/home/ 4 | redirect_from: /index.html 5 | --- 6 | 7 | ### AppImage中文文档 8 | 9 | 10 | 11 | 本系列文档是用Markdown编写的(`.md`)，是AppImage开发所在的GitHub.com上各种文档的主要集合。中文文档github地址在[这里](https://github.com/Gamuxorg/AppImage-CN/tree/master/_docs),官方英文文档地址在[这里](https://github.com/AppImage/AppImageKit/wiki)，欢迎参加建设文档。 12 | 13 | 如果你看了文档还不够了解AppImage的话，不要害怕提问。由于AppImage的开发速度非常快，部分文档可能已经过时。 14 | 15 | AppImage官方网站是appimage.org，你可以到该处获得更多帮助。 16 | 非常感谢你对AppImage的支持，最后不要忘记到[这里](https://github.com/AppImage/AppImageKit)为AppImage添加star！ 17 | -------------------------------------------------------------------------------- /_docs/pkg2appimage.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 从deb包或ppa构建AppImage 3 | permalink: /docs/pkg2appimage/ 4 | --- 5 | 6 | ### 从deb包或ppa构建AppImage 7 | 8 | 有 [多种方式](https://github.com/probonopd/AppImageKit/wiki/Creating-AppImages) 生成AppImage。如果你已经有了二进制文件（无论是程序压缩包还是 `.deb` 格式亦或 ppa），那么将这些二进制文件转换为 AppImage 的推荐方法是编写一个 [.yml描述文件](https://github.com/AppImage/AppImages/tree/master/recipes) 并使用 [pkg2appimage](https://github.com/AppImage/AppImages/tree/master/pkg2appimage) 运行它： 9 | 10 | 从 `.yml` 描述文件构建一个 AppImage： 11 | 12 | ``` 13 | bash -ex ./pkg2appimage XXX.yml 14 | ``` 15 | 也可以将yml文件放在本地，然后运行 16 | ``` 17 | bash -ex ./pkg2appimage ./XXX.yml 18 | ``` 19 | `.yml` 描述文件可以告诉 pkg2appimage 从哪里获取应用的各个组成部分，以及如何将它们转换为 AppImage（除了已经包含在 pkg2appimage 中的统一步骤）。你可以学习一些 [示例](https://github.com/AppImage/AppImages/tree/master/recipes)，观察它是如何工作的。 20 | 21 | 代码库 [AppImageKit](https://github.com/probonopd/appimagekit) 包含工具 `pkg2appimage` 和一些生成 __AppImage__（即便携式Linux应用程序）的“配方”(recipes)。你也可以前往 [Bintray Page](https://bintray.com/probono/AppImages) 下载已经生成好的AppImage。 22 | 23 | __配方(recipes)__ 是指用于创建AppImage的 `.yml` 文件。 24 | -------------------------------------------------------------------------------- /_docs/wiki.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 总结 3 | permalink: /docs/wiki/ 4 | --- 5 | 6 | [原文链接](https://github.com/AppImage/AppImageKit/wiki) 7 | # AppImageKit Wiki 8 | 9 | 每个人都可以在 https://github.com/AppImage/AppImageKit 编辑wiki 10 | 11 | ## 对于用户而言 12 | 13 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)AppImage是什么？ 14 | 15 | 一个AppImage应用即是一个可下载的Linux文件，其中包含一个应用程序和应用程序运行需要的所有内容（例如，库，图标，字体，转换层等），而这些内容并不一定已经存在于每个目标系统之中。 16 | 17 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)如何运行一个AppImage应用？ 18 | 19 | [添加可执行的权限](http://discourse.appimage.org/t/how-to-make-an-appimage-executable/80)并双击它运行。 20 | 21 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)如何将AppImage应用集成到系统里？ 22 | 23 | 使用可选的`appimaged`守护进程，可以轻松地将AppImage应用与系统集成。守护进程将为AppImage应用创建菜单，注册MIME类型，图标，所有一切都可以自动完成。你可以从这个仓库下载它，再次重申这是非必选项。 24 | 25 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)哪里可以下载AppImage应用？ 26 | 前往[AppImageHub](https://appimage.github.io/apps/)查看所有收录的AppImage应用。 27 | 28 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)AppImage应用安放在哪里比较合适？ 29 | 如果你不想把它们放在`$HOME/Downloads`中，那么 `$HOME/.local/bin` 和 `$HOME/bin` 是很好的选择： 30 | * 在 CentOS/RHEL 和 Fedora 上：脚本`$HOME/.bash_profile`在登录时运行，这个脚本将`$HOME/.local/bin:$HOME/bin`添加到路径中。 31 | * 在Ubuntu上：脚本`$HOME/.profile`在登录时运行，这个脚本将`PATH="$HOME/bin:$HOME/.local/bin"`添加到路径中。 32 | 33 | 此外，存储任何其他位置也是可以，例如U盘，网络位置或光盘，但是这样AppImage应用的路径不在环境变量中，意味着不能简单地在终端输入应用名来运行，而必须使用完整的路径。 34 | 35 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)我想要的应用没有AppImage打包版本怎么办？ 36 | 如果您想运行的应用没有AppImage版本，请您向该应用的作者请求，例如您可以使用应用的问题反馈功能进行提议。举个例子，如果您想要Mozilla Firefox的AppImage版本，请在 https://bugzilla.mozilla.org/show_bug.cgi?id=1249971 上留言。向上游作者请求AppImage的人越多，则提供AppImage版本的可能性就越大。 37 | 38 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)我在哪里可以得到相关技术支持？ 39 | 40 | 请访问[官方论坛](http://discourse.appimage.org/) 。论坛支持Google或GitHub帐户登录，无需注册。 41 | 42 | ## 对于应用程序开发者而言 43 | 44 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)为什么要将我的应用程序打包成AppImage？ 45 | 46 | 通过将您的应用程序打包成AppImage，您可以像Windows(exe)和MacOS(dmg)所使用技术方式类似，为Linux用户提供官方的、便捷和简单的软件下载和安装方式，您作为应用程序作者直接掌握端到端的用户体验，而无需任何中介（打包）横亘在开发者您和最终用户之间。只需打包成AppImage格式，就可以连结大多数Linux发行版的用户。您可以随时提供新的下载链接，甚至可以为持续构建的项目提供快速不停的更新。 47 | 48 | 比如，制作AppImage有如下好处： 49 | - 只需打包一次即可运行在大多数主流Linux发行版 50 | - 开箱即用，运行时无需安装 51 | - 不需要root权限 52 | - 一个应用程序 ＝ 一个文件 ＝ 极度便利的用户检验 53 | - 可选（！）的`appimaged`用于将AppImage集成入桌面环境 54 | - 二进制增量更新，例如，使用AppImageUpdate用于连续构建时升级应用（只下载二进制增量数据） 55 | - 可以以GPG2的形式签署您的AppImages（文件内） 56 | 57 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)如何将我的应用程序打包为AppImage？ 58 | 59 | 有下面几种方式生成您的AppImage应用： 60 | 61 | 1. 转换现有的二进制包，或者 62 | 2. 将您的`Travis CI builds`打包成AppImage应用，或者 63 | 3. 使用[linuxdeployqt](https://github.com/probonopd/linuxdeployqt/)工具转换您的Qt应用程序，或者 64 | 4. 使用`electron-builder`，或者 65 | 5. 自己编写 66 | 67 | 更多详情和示例，请参见 https://github.com/probonopd/AppImageKit/wiki/Creating-AppImages 68 | 69 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)打包自己的AppImage应用过程中如何得到官方帮助？ 70 | 71 | 我们尽力帮助上游应用程序作者，请应用作者通过在AppImage项目中新增一个[issue](https://github.com/AppImage/AppImageKit/issues)的方式获得支持。如果您不是上游应用程序作者，在发起issue之前请先联系上游应用程序作者。 72 | 73 | ## 对于AppImage开发者而言 74 | 75 | ### ![question-logo](https://raw.githubusercontent.com/encharm/Font-Awesome-SVG-PNG/master/black/png/48/question-circle.png)如何参与AppImage项目做出贡献？ 76 | 77 | 对AppImage开发感到好奇？想做出自己的贡献？我们欢迎通过`pull requests`方式来解决任何公开问题和（或）其他错误修正和（或）功能的添加。在添加复杂功能的情况前，最好先与官方沟通联系以免徒耗时间。请参阅我们的[问题列表](https://github.com/probonopd/AppImageKit/issues)，并在`irc.freenode.net`上的`＃AppImage`频道中与我们联系。 78 | -------------------------------------------------------------------------------- /_includes/docs_nav.html: -------------------------------------------------------------------------------- 1 |
2 | {% for section in site.data.docs %} 3 |
4 |
5 |

6 | 9 |

10 |
11 |
12 |
    13 | {% for item in section.docs %} 14 | {% assign item_url = item | prepend:"/docs/" | append:"/" %} 15 | {% assign p = site.docs | where:"url", item_url | first %} 16 | {{ p.title }} 17 | {% endfor %} 18 |
19 |
20 |
21 | {% endfor %} 22 |
23 | -------------------------------------------------------------------------------- /_includes/footer.html: -------------------------------------------------------------------------------- 1 | 13 | -------------------------------------------------------------------------------- /_includes/head.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | {{ page.title }} - {{ site.title }} 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | {% seo %} 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /_includes/js_files.html: -------------------------------------------------------------------------------- 1 | 4 | 5 | 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /_includes/section_nav.html: -------------------------------------------------------------------------------- 1 | {% comment %} 2 | Map grabs the doc sections, giving us an array of arrays. Join, flattens all 3 | the items to a comma delimited string. Split turns it into an array again. 4 | {% endcomment %} 5 | {% assign docs = site.data.docs | map: 'docs' | join: ',' | split: ',' %} 6 | 7 | {% comment %} 8 | Because this is built for every page, lets find where we are in the ordered 9 | document list by comparing url strings. Then if there's something previous or 10 | next, lets build a link to it. 11 | {% endcomment %} 12 | 13 | {% for document in docs %} 14 | {% assign document_url = document | prepend:"/docs/" | append:"/" %} 15 | {% if document_url == page.url %} 16 |