mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions 1

docs: Some tunes on desktop-environment-integration.md

Browse source
This commit is contained in:
Cheng Zhao 2014-11-18 10:16:17 +08:00
parent 2513358eb5
commit 2f36216cb0
1 changed files with 16 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

23
docs/tutorial/desktop-environment-integration.md
View file

@ -8,9 +8,9 @@ applications can put a custom menu in the dock menu.
This guide introduces how to integrate your application into those desktop
environments with atom-shell APIs.
## Recent documents
## Recent documents (Windows & OS X)
Windows and Mac OS X have provided easy access to recent documents opened by the
Windows and OS X have provided easy access to recent documents opened by the
application via JumpList and dock menu.
__JumpList:__
@ -21,15 +21,16 @@ __Application dock menu:__
<img src="https://cloud.githubusercontent.com/assets/639601/5069610/2aa80758-6e97-11e4-8cfb-c1a414a10774.png" height="274" width="332" >
To add a file to recent documents, you can use `app.addRecentDocument` API:
To add a file to recent documents, you can use
[app.addRecentDocument][addrecentdocument] API:
```javascript
var app = require('app');
app.addRecentDocument('/Users/aryastark/github/atom-shell/README.md');
```
And you can use `app.clearRecentDocuments` API to empty the recent documents
list:
And you can use [app.clearRecentDocuments](clearrecentdocuments) API to empty
the recent documents list:
```javascript
app.clearRecentDocuments();
@ -106,7 +107,8 @@ Unlike the dock menu in OS X which is a real menu, user tasks in Windows work
like application shortcuts that when user clicks a task a program would be
executed with specified arguments.
To set user tasks for your application, you can use `app.setUserTasks` API:
To set user tasks for your application, you can use
[app.setUserTasks][setusertaskstasks] API:
```javascript
var app = require('app');
@ -132,10 +134,17 @@ The user tasks will still show even after your application closes, so the icon
and program path specified for a task should exist until your application is
uninstalled.
## Unity integration (Linux)
## Unity launcher shortcuts (Linux)
In Unity, you can add custom entries to its launcher via modifying `.desktop`
file, see [Adding shortcuts to a launcher][unity-launcher].
__Launcher shortcuts of Audacious:__
![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png)
[addrecentdocument]:../api/app.md#appaddrecentdocumentpath
[clearrecentdocuments]:../api/app.md#appclearrecentdocuments
[setusertaskstasks]:../api/app.md#appsetusertaskstasks
[app-registration]:http://msdn.microsoft.com/en-us/library/windows/desktop/ee872121(v=vs.85).aspx
[unity-launcher]:https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles#Adding_shortcuts_to_a_launcher