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 This guide introduces how to integrate your application into those desktop
environments with atom-shell APIs. 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. application via JumpList and dock menu.
__JumpList:__ __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" > <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 ```javascript
var app = require('app'); var app = require('app');
app.addRecentDocument('/Users/aryastark/github/atom-shell/README.md'); app.addRecentDocument('/Users/aryastark/github/atom-shell/README.md');
``` ```
And you can use `app.clearRecentDocuments` API to empty the recent documents And you can use [app.clearRecentDocuments](clearrecentdocuments) API to empty
list: the recent documents list:
```javascript ```javascript
app.clearRecentDocuments(); 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 like application shortcuts that when user clicks a task a program would be
executed with specified arguments. 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 ```javascript
var app = require('app'); 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 and program path specified for a task should exist until your application is
uninstalled. uninstalled.
## Unity integration (Linux) ## Unity launcher shortcuts (Linux)
In Unity, you can add custom entries to its launcher via modifying `.desktop` In Unity, you can add custom entries to its launcher via modifying `.desktop`
file, see [Adding shortcuts to a launcher][unity-launcher]. 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 [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 [unity-launcher]:https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles#Adding_shortcuts_to_a_launcher