diff --git a/CONTRIBUTING-ko.md b/CONTRIBUTING-ko.md index fe3eb90b68c..480c2f73e47 100644 --- a/CONTRIBUTING-ko.md +++ b/CONTRIBUTING-ko.md @@ -68,7 +68,7 @@ * :non-potable_water: `:non-potable_water:` 메모리 누수를 연결했을 때 * :memo: `:memo:` 문서를 작성했을 때 * :penguin: `:penguin:` Linux에 대한 패치를 했을 때 - * :apple: `:apple:` Mac OS에 대한 패치를 했을 때 + * :apple: `:apple:` macOS에 대한 패치를 했을 때 * :checkered_flag: `:checkered_flag:` Windows에 대한 패치를 했을 때 * :bug: `:bug:` 버그를 고쳤을 때 * :fire: `:fire:` 코드 또는 파일을 삭제했을 때 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d6bc3cb2d67..736f0b22ef7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -65,7 +65,7 @@ possible with your report. If you can, please include: * :non-potable_water: `:non-potable_water:` when plugging memory leaks * :memo: `:memo:` when writing docs * :penguin: `:penguin:` when fixing something on Linux - * :apple: `:apple:` when fixing something on Mac OS + * :apple: `:apple:` when fixing something on macOS * :checkered_flag: `:checkered_flag:` when fixing something on Windows * :bug: `:bug:` when fixing a bug * :fire: `:fire:` when removing code or files diff --git a/README-ko.md b/README-ko.md index 7cabe5ed456..a6eab54471c 100644 --- a/README-ko.md +++ b/README-ko.md @@ -22,7 +22,7 @@ Electron에 대한 중요한 알림을 받고 싶다면 Twitter에서 ## 다운로드 -Linux, Windows, OS X 용으로 미리 빌드된 Electron 바이너리와 디버그 심볼이 준비되어 +Linux, Windows, macOS 용으로 미리 빌드된 Electron 바이너리와 디버그 심볼이 준비되어 있습니다. [releases](https://github.com/electron/electron/releases) 페이지에서 받아 볼 수 있습니다. diff --git a/README.md b/README.md index b1e0d6b1b9a..83ba1f5a618 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ behavior to electron@github.com. ## Downloads -Prebuilt binaries and debug symbols of Electron for Linux, Windows and OS X can +Prebuilt binaries and debug symbols of Electron for Linux, Windows and macOS can be found on the [releases](https://github.com/electron/electron/releases) page. You can also use [`npm`](https://docs.npmjs.com/) to install prebuilt electron diff --git a/atom/browser/atom_browser_main_parts.cc b/atom/browser/atom_browser_main_parts.cc index 335e0576fcb..75f71d42314 100644 --- a/atom/browser/atom_browser_main_parts.cc +++ b/atom/browser/atom_browser_main_parts.cc @@ -148,7 +148,7 @@ void AtomBrowserMainParts::PreMainMessageLoopRun() { #endif #if !defined(OS_MACOSX) - // The corresponding call in OS X is in AtomApplicationDelegate. + // The corresponding call in macOS is in AtomApplicationDelegate. Browser::Get()->WillFinishLaunching(); Browser::Get()->DidFinishLaunching(); #endif diff --git a/atom/browser/browser_mac.mm b/atom/browser/browser_mac.mm index 4561eab8c95..a50de2a07f6 100644 --- a/atom/browser/browser_mac.mm +++ b/atom/browser/browser_mac.mm @@ -58,7 +58,7 @@ bool Browser::RemoveAsDefaultProtocolClient(const std::string& protocol) { if (!bundleList) { return false; } - // On Mac OS X, we can't query the default, but the handlers list seems to put + // On macOS, we can't query the default, but the handlers list seems to put // Apple's defaults first, so we'll use the first option that isn't our bundle CFStringRef other = nil; for (CFIndex i = 0; i < CFArrayGetCount(bundleList); i++) { diff --git a/atom/browser/browser_observer.h b/atom/browser/browser_observer.h index 41aeceb6375..6e85b599d03 100644 --- a/atom/browser/browser_observer.h +++ b/atom/browser/browser_observer.h @@ -33,7 +33,7 @@ class BrowserObserver { virtual void OnQuit() {} // The browser has opened a file by double clicking in Finder or dragging the - // file to the Dock icon. (OS X only) + // file to the Dock icon. (macOS only) virtual void OnOpenFile(bool* prevent_default, const std::string& file_path) {} @@ -53,7 +53,7 @@ class BrowserObserver { const base::DictionaryValue& request_details) {} #if defined(OS_MACOSX) - // The browser wants to resume a user activity via handoff. (OS X only) + // The browser wants to resume a user activity via handoff. (macOS only) virtual void OnContinueUserActivity( bool* prevent_default, const std::string& type, diff --git a/atom/browser/native_window.h b/atom/browser/native_window.h index 796cf21326a..a644682e345 100644 --- a/atom/browser/native_window.h +++ b/atom/browser/native_window.h @@ -320,7 +320,7 @@ class NativeWindow : public base::SupportsUserData, base::CancelableClosure window_unresposive_closure_; // Used to display sheets at the appropriate horizontal and vertical offsets - // on OS X. + // on macOS. double sheet_offset_x_; double sheet_offset_y_; diff --git a/atom/browser/native_window_mac.mm b/atom/browser/native_window_mac.mm index 0a6430202dd..679b1dc0ec1 100644 --- a/atom/browser/native_window_mac.mm +++ b/atom/browser/native_window_mac.mm @@ -232,7 +232,7 @@ bool ScopedDisableResize::disable_resize_ = false; } - (void)windowDidExitFullScreen:(NSNotification*)notification { - // For certain versions of OS X the fullscreen button will automatically show + // For certain versions of macOS the fullscreen button will automatically show // after exiting fullscreen mode. if (!shell_->has_frame()) { NSWindow* window = shell_->GetNativeWindow(); @@ -537,7 +537,7 @@ NativeWindowMac::NativeWindowMac( [window_ setToolbar:toolbar]; } - // On OS X the initial window size doesn't include window frame. + // On macOS the initial window size doesn't include window frame. bool use_content_size = false; options.Get(options::kUseContentSize, &use_content_size); if (!has_frame() || !use_content_size) @@ -1041,7 +1041,7 @@ void NativeWindowMac::InstallView() { [[window_ standardWindowButton:NSWindowMiniaturizeButton] setHidden:YES]; [[window_ standardWindowButton:NSWindowCloseButton] setHidden:YES]; - // Some third-party OS X utilities check the zoom button's enabled state to + // Some third-party macOS utilities check the zoom button's enabled state to // determine whether to show custom UI on hover, so we disable it here to // prevent them from doing so in a frameless app window. [[window_ standardWindowButton:NSWindowZoomButton] setEnabled:NO]; @@ -1111,7 +1111,7 @@ void NativeWindowMac::SetStyleMask(bool on, NSUInteger flag) { else [window_ setStyleMask:[window_ styleMask] & (~flag)]; // Change style mask will make the zoom button revert to default, probably - // a bug of Cocoa or OS X. + // a bug of Cocoa or macOS. if (!zoom_button_enabled) SetMaximizable(false); } @@ -1123,7 +1123,7 @@ void NativeWindowMac::SetCollectionBehavior(bool on, NSUInteger flag) { else [window_ setCollectionBehavior:[window_ collectionBehavior] & (~flag)]; // Change collectionBehavior will make the zoom button revert to default, - // probably a bug of Cocoa or OS X. + // probably a bug of Cocoa or macOS. if (!zoom_button_enabled) SetMaximizable(false); } diff --git a/atom/browser/ui/message_box_mac.mm b/atom/browser/ui/message_box_mac.mm index d553a6a7dfb..8fd28e24463 100644 --- a/atom/browser/ui/message_box_mac.mm +++ b/atom/browser/ui/message_box_mac.mm @@ -79,7 +79,7 @@ NSAlert* CreateNSAlert(NativeWindow* parent_window, for (size_t i = 0; i < buttons.size(); ++i) { NSString* title = base::SysUTF8ToNSString(buttons[i]); - // An empty title causes crash on OS X. + // An empty title causes crash on macOS. if (buttons[i].empty()) title = @"(empty)"; NSButton* button = [alert addButtonWithTitle:title]; diff --git a/atom/browser/ui/tray_icon.h b/atom/browser/ui/tray_icon.h index dd018821cd3..1916c11b23a 100644 --- a/atom/browser/ui/tray_icon.h +++ b/atom/browser/ui/tray_icon.h @@ -40,11 +40,11 @@ class TrayIcon { virtual void SetToolTip(const std::string& tool_tip) = 0; // Sets the title displayed aside of the status icon in the status bar. This - // only works on OS X. + // only works on macOS. virtual void SetTitle(const std::string& title); // Sets whether the status icon is highlighted when it is clicked. This only - // works on OS X. + // works on macOS. virtual void SetHighlightMode(bool highlight); // Displays a notification balloon with the specified contents. diff --git a/atom/browser/ui/tray_icon_cocoa.mm b/atom/browser/ui/tray_icon_cocoa.mm index c3fa3f3b927..0dfd59132ae 100644 --- a/atom/browser/ui/tray_icon_cocoa.mm +++ b/atom/browser/ui/tray_icon_cocoa.mm @@ -12,9 +12,9 @@ namespace { -// By default, OS X sets 4px to tray image as left and right padding margin. +// By default, macOS sets 4px to tray image as left and right padding margin. const CGFloat kHorizontalMargin = 4; -// OS X tends to make the title 2px lower. +// macOS tends to make the title 2px lower. const CGFloat kVerticalTitleMargin = 2; } // namespace diff --git a/atom/common/api/atom_bindings.cc b/atom/common/api/atom_bindings.cc index f567492b52b..599fc674989 100644 --- a/atom/common/api/atom_bindings.cc +++ b/atom/common/api/atom_bindings.cc @@ -64,7 +64,7 @@ v8::Local GetSystemMemoryInfo(v8::Isolate* isolate, dict.Set("total", mem_info.total); dict.Set("free", mem_info.free); - // NB: These return bogus values on OS X + // NB: These return bogus values on macOS #if !defined(OS_MACOSX) dict.Set("swapTotal", mem_info.swap_total); dict.Set("swapFree", mem_info.swap_free); diff --git a/atom/common/node_includes.h b/atom/common/node_includes.h index 3734a43e5f4..46b6fa058eb 100644 --- a/atom/common/node_includes.h +++ b/atom/common/node_includes.h @@ -22,7 +22,7 @@ #undef DISALLOW_COPY_AND_ASSIGN #undef NO_RETURN #undef arraysize -#undef debug_string // This is defined in OS X 10.9 SDK in AssertMacros.h. +#undef debug_string // This is defined in macOS 10.9 SDK in AssertMacros.h. #include "vendor/node/src/env.h" #include "vendor/node/src/env-inl.h" #include "vendor/node/src/node.h" diff --git a/atom/common/options_switches.cc b/atom/common/options_switches.cc index 04e268c66e2..36ec19edb86 100644 --- a/atom/common/options_switches.cc +++ b/atom/common/options_switches.cc @@ -66,7 +66,7 @@ const char kType[] = "type"; // Disable auto-hiding cursor. const char kDisableAutoHideCursor[] = "disableAutoHideCursor"; -// Use the OS X's standard window instead of the textured window. +// Use the macOS' standard window instead of the textured window. const char kStandardWindow[] = "standardWindow"; // Default browser window background color. diff --git a/common.gypi b/common.gypi index 29fe70afc02..3389e18690a 100644 --- a/common.gypi +++ b/common.gypi @@ -124,7 +124,7 @@ ], 'conditions': [ ['OS=="mac" and libchromiumcontent_component==0', { - # -all_load is the "whole-archive" on OS X. + # -all_load is the "whole-archive" on macOS. 'xcode_settings': { 'OTHER_LDFLAGS': [ '-Wl,-all_load' ], }, diff --git a/docs-translations/es/api/process.md b/docs-translations/es/api/process.md index e50a2c1aac6..1a905125de2 100644 --- a/docs-translations/es/api/process.md +++ b/docs-translations/es/api/process.md @@ -38,7 +38,7 @@ El objeto `process` tiene los siguientes métodos: Interrumpe el hilo principal del proceso actual. -### process.setFdLimit(maxDescriptors) _OS X_ _Linux_ +### process.setFdLimit(maxDescriptors) _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs-translations/es/development/build-instructions-osx.md b/docs-translations/es/development/build-instructions-osx.md index 2ac3641e836..05c3a44f3d5 100644 --- a/docs-translations/es/development/build-instructions-osx.md +++ b/docs-translations/es/development/build-instructions-osx.md @@ -1,9 +1,9 @@ #Instrucciones de Compilación (Mac) -Siga las siguientes pautas para la construcción de Electron en OS X. +Siga las siguientes pautas para la construcción de Electron en macOS. #Requisitos previos - `OS X >= 10.8` + `macOS >= 10.8` `Xcode >= 5.1` `node.js (external)` @@ -36,7 +36,7 @@ Después de la construcción está hecho, usted puede encontrar `Electron.app` b #Soporte de 32bit -Electron sólo puede construirse para un objetivo de 64 bits en OS X y no hay un plan para apoyar a 32 bit OS X en el futuro. +Electron sólo puede construirse para un objetivo de 64 bits en macOS y no hay un plan para apoyar a 32 bit macOS en el futuro. #Pruebas diff --git a/docs-translations/es/styleguide.md b/docs-translations/es/styleguide.md index 18fa1aa3bb3..e7138aeb846 100644 --- a/docs-translations/es/styleguide.md +++ b/docs-translations/es/styleguide.md @@ -26,7 +26,7 @@ Estas son las maneras en las que construimos la documentación de Electron. - Argumentos opcionales son denotados cuando se llaman en listas. - Delimitador de línea de 80-columnas. - Métodos específicos de Plataformas son denotados en itálicas seguidas por la cabecera del método. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` - Preferir 'en el ___ proceso' en lugar de 'sobre el' ### Traducciones de la Documentación diff --git a/docs-translations/es/tutorial/application-distribution.md b/docs-translations/es/tutorial/application-distribution.md index 5966cdad7ec..f595b9eea15 100644 --- a/docs-translations/es/tutorial/application-distribution.md +++ b/docs-translations/es/tutorial/application-distribution.md @@ -5,7 +5,7 @@ aplicación deberá llamarse `app`, y ser colocado debajo del directorio de recursos de Electron (en OSX es `Electron.app/Contents/Resources/`, en Linux y Windows es `resources/`), de esta forma: -En OS X: +En macOS: ```text electron/Electron.app/Contents/Resources/app/ @@ -37,7 +37,7 @@ Para utilizar un archivo `asar` en reemplazo del directorio `app`, debes de renombrar el archivo a `app.asar`, y colocarlo por debajo el directorio de recursos de Electron (ver en seguida), Electron intentará leer el archivo y arrancar desde el. -En OS X: +En macOS: ```text electron/Electron.app/Contents/Resources/ diff --git a/docs-translations/es/tutorial/desktop-environment-integration.md b/docs-translations/es/tutorial/desktop-environment-integration.md index f19f36326f3..7db66c58043 100644 --- a/docs-translations/es/tutorial/desktop-environment-integration.md +++ b/docs-translations/es/tutorial/desktop-environment-integration.md @@ -6,9 +6,9 @@ en la JumpList de la barra de tareas, y en Mac, las aplicaciones pueden agregar Esta guía explica cómo integrar tu aplicación en esos entornos de escritorio a través de las APIs de Electron. -## Documentos recientes (Windows y OS X) +## Documentos recientes (Windows y macOS) -Windows y OS X proveen un acceso sencillo a la lista de documentos recientes. +Windows y macOS proveen un acceso sencillo a la lista de documentos recientes. __JumpList:__ @@ -42,14 +42,14 @@ registrar tu aplicación en [Application Registration][app-registration]. Cuando un usuario haga click en un archivo de la JumpList, una nueva instancia de tu aplicación se iniciará, la ruta del archivo se agregará como un argumento de la línea de comandos. -### Notas sobre OS X +### Notas sobre macOS Cuando un archivo es solicitado desde el menú de documentos recientes, el evento `open-file` del módulo `app` será emitido. -## Menú dock personalizado (OS X) +## Menú dock personalizado (macOS) -OS X permite a los desarrolladores definir un menú personalizado para el dock, +macOS permite a los desarrolladores definir un menú personalizado para el dock, el cual usualmente contiene algunos accesos directos a las características más comunes de tu aplicación: @@ -99,7 +99,7 @@ __Tareas de Internet Explorer:__ ![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png) -A diferencia del menú dock en OS X, el cual es un menú real, las tareas de usuario en Windows +A diferencia del menú dock en macOS, el cual es un menú real, las tareas de usuario en Windows funcionan como accesos directos de aplicación, que al ser clickeados, lanzan el programa con argumentos específicos. diff --git a/docs-translations/es/tutorial/quick-start.md b/docs-translations/es/tutorial/quick-start.md index 9e65042c503..47008d6f5fc 100644 --- a/docs-translations/es/tutorial/quick-start.md +++ b/docs-translations/es/tutorial/quick-start.md @@ -74,7 +74,7 @@ var mainWindow = null; // Salir de todas las ventanas cuando se cierren. app.on('window-all-closed', function() { - // En OS X es común que las aplicaciones y su barra de menú + // En macOS es común que las aplicaciones y su barra de menú // se mantengan activas hasta que el usuario cierre la aplicación // explícitamente utilizando Cmd + Q if (process.platform != 'darwin') { @@ -139,7 +139,7 @@ En Linux: $ ./electron/electron your-app/ ``` -En OS X: +En macOS: ```bash $ ./Electron.app/Contents/MacOS/Electron your-app/ diff --git a/docs-translations/es/tutorial/supported-platforms.md b/docs-translations/es/tutorial/supported-platforms.md index 95ccc267722..ff08a5e1483 100644 --- a/docs-translations/es/tutorial/supported-platforms.md +++ b/docs-translations/es/tutorial/supported-platforms.md @@ -2,10 +2,10 @@ Las siguientes plataformas son soportadas por Electron: -### OS X +### macOS -Sólo se proveen binarios de 64 bit para OS X. -La versión mínima soportada es OS X 10.8. +Sólo se proveen binarios de 64 bit para macOS. +La versión mínima soportada es macOS 10.8. ### Windows diff --git a/docs-translations/es/tutorial/using-pepper-flash-plugin.md b/docs-translations/es/tutorial/using-pepper-flash-plugin.md index 5c41ff87826..85176f7f864 100644 --- a/docs-translations/es/tutorial/using-pepper-flash-plugin.md +++ b/docs-translations/es/tutorial/using-pepper-flash-plugin.md @@ -28,7 +28,7 @@ app.on('window-all-closed', function() { // Specify flash path. // On Windows, it might be /path/to/pepflashplayer.dll -// On OS X, /path/to/PepperFlashPlayer.plugin +// On macOS, /path/to/PepperFlashPlayer.plugin // On Linux, /path/to/libpepflashplayer.so app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so'); diff --git a/docs-translations/fr-FR/README.md b/docs-translations/fr-FR/README.md index 666a03e99a3..fc505bc770c 100644 --- a/docs-translations/fr-FR/README.md +++ b/docs-translations/fr-FR/README.md @@ -85,7 +85,7 @@ dans la FAQ : * [Hiérarchie du Code Source](development/source-code-directory-structure.md) * [Différences Techniques par rapport à NW.js (anciennement node-webkit)](development/atom-shell-vs-node-webkit.md) * [Aperçu du Système de Build](development/build-system-overview.md) -* [Instructions de Build (OS X)](development/build-instructions-osx.md) +* [Instructions de Build (macOS)](development/build-instructions-osx.md) * [Instructions de Build (Windows)](development/build-instructions-windows.md) * [Instructions de Build (Linux)](development/build-instructions-linux.md) * [Installer un Serveur de Symbol dans le debugger](development/setting-up-symbol-server.md) diff --git a/docs-translations/fr-FR/styleguide.md b/docs-translations/fr-FR/styleguide.md index b683ee68aad..9dac1955aef 100644 --- a/docs-translations/fr-FR/styleguide.md +++ b/docs-translations/fr-FR/styleguide.md @@ -27,7 +27,7 @@ La documentation d'Electron a été écrite en suivant les règles ci-dessous : - Les arguments optionnels sont indiqués quand appelés dans la liste. - La longueur des lignes ne dépasse pas 80 caractères. - Les méthodes spécifiques à une plateforme sont notées en italique. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` - Préférer 'in the ___ process' au lieu de 'on' ### Traductions de la Documentation diff --git a/docs-translations/jp/README.md b/docs-translations/jp/README.md index 7359745d6c0..734bc8274c5 100644 --- a/docs-translations/jp/README.md +++ b/docs-translations/jp/README.md @@ -89,7 +89,7 @@ _リンクになっていないリストは未翻訳のものです。_ * Source Code Directory Structure (development/source-code-directory-structure.md) * Technical Differences to NW.js (formerly node-webkit)(development/atom-shell-vs-node-webkit.md) * Build System Overview (development/build-system-overview.md) -* Build Instructions (OS X) (development/build-instructions-osx.md) +* Build Instructions (macOS) (development/build-instructions-osx.md) * Build Instructions (Windows) (development/build-instructions-windows.md) * Build Instructions (Linux) (development/build-instructions-linux.md) * Debug Instructions (Windows) (development/debug-instructions-windows.md) diff --git a/docs-translations/jp/api/accelerator.md b/docs-translations/jp/api/accelerator.md index 83a66447ed5..032747ddf60 100644 --- a/docs-translations/jp/api/accelerator.md +++ b/docs-translations/jp/api/accelerator.md @@ -10,9 +10,9 @@ acceleratorは、キーボードショートカットを示す文字列です。 ## プラットフォームの留意点 -OS Xでは`Command` キー、LinuxとWindowsでは`Control` キーを意味する`CommandOrControl`はいくつかのacceleratorを定義しますが、LinuxとWindowsでは、`Command` キーは何の効果もありません。 +macOSでは`Command` キー、LinuxとWindowsでは`Control` キーを意味する`CommandOrControl`はいくつかのacceleratorを定義しますが、LinuxとWindowsでは、`Command` キーは何の効果もありません。 - `Super` キーは、WindowsとLinuxでは `Windows` キーに、OS Xでは、`Cmd` キーに関連付けられます。 + `Super` キーは、WindowsとLinuxでは `Windows` キーに、macOSでは、`Cmd` キーに関連付けられます。 ## 提供されている修飾語句 diff --git a/docs-translations/jp/api/app.md b/docs-translations/jp/api/app.md index 168f7a09399..2adac343033 100644 --- a/docs-translations/jp/api/app.md +++ b/docs-translations/jp/api/app.md @@ -17,7 +17,7 @@ app.on('window-all-closed', function() { ### イベント: 'will-finish-launching' -アプリケーションの基礎起動が終わったときに出力されます。Windows と Linuxでは、 `will-finish-launching` イベントと`ready`イベントは同じです。OS Xでは、`NSApplication`の `applicationWillFinishLaunching` 通知をに相当します。通常、`open-file`と`open-url` 用のリスナーの設定、クラッシュレポートの開始、自動アップデートをします。 +アプリケーションの基礎起動が終わったときに出力されます。Windows と Linuxでは、 `will-finish-launching` イベントと`ready`イベントは同じです。macOSでは、`NSApplication`の `applicationWillFinishLaunching` 通知をに相当します。通常、`open-file`と`open-url` 用のリスナーの設定、クラッシュレポートの開始、自動アップデートをします。 ほとんどの場合、 `ready` イベントハンドラーですべてをするべきです。 @@ -58,7 +58,7 @@ Electronの初期化が終わった時に出力します。 アプリケーションが終了したときに出力されます。 -### イベント: 'open-file' _OS X_ +### イベント: 'open-file' _macOS_ 戻り値: @@ -71,7 +71,7 @@ Electronの初期化が終わった時に出力します。 Windowsでは、ファイルパスを取得するために、 `process.argv` をパースする必要があります。 -### イベント: 'open-url' _OS X_ +### イベント: 'open-url' _macOS_ 戻り値: @@ -82,7 +82,7 @@ Windowsでは、ファイルパスを取得するために、 `process.argv` を このイベントをハンドルしたい場合は、`event.preventDefault()`をコールすべきです。 -### イベント: 'activate' _OS X_ +### イベント: 'activate' _macOS_ 戻り値: @@ -237,7 +237,7 @@ gpu プロセスがクラッシュしたときに出力されます。 * `appData` 既定で示すユーザーごとのアプリケーションディレクトリ * `%APPDATA%` Windows上 * `$XDG_CONFIG_HOME` or `~/.config` Linux上 - * `~/Library/Application Support` OS X上 + * `~/Library/Application Support` macOS上 * `userData` アプリの設定ファイルを格納するディレクトリで、既定では`appData` ディレクトリ配下のアプリ名ディレクトリです * `temp` 一時ディレクトリ * `exe` 現在の実行ファイル @@ -274,15 +274,15 @@ gpu プロセスがクラッシュしたときに出力されます。 現在のアプリケーションのロケールを戻します。 -### `app.addRecentDocument(path)` _OS X_ _Windows_ +### `app.addRecentDocument(path)` _macOS_ _Windows_ * `path` String 最近のドキュメント一覧に`path`を追加します。 -この一覧はOSが管理しています。Windowsではタスクバーからこの一覧を見れ、OS Xではdockメニューから見れます。 +この一覧はOSが管理しています。Windowsではタスクバーからこの一覧を見れ、macOSではdockメニューから見れます。 -### `app.clearRecentDocuments()` _OS X_ _Windows_ +### `app.clearRecentDocuments()` _macOS_ _Windows_ 最近のドキュメント一覧をクリアします。 @@ -321,7 +321,7 @@ The `callback` は、 `app`の`ready` イベントの出力後に実行するこ プロセスがアプリケーションのプライマリインスタンスでアプリがロードし続けるなら、このメソッドは `false`を戻します。プロセスがほかのインスタンスにパラメーターを送信し、`true`を戻すと、直ちに終了します。 -OS Xは、ユーザーがFinderで2つ目のアプリインスタンスを開いたり、`open-file` 、 `open-url`イベントが出力しようとすると、システムが自動的にシングルインスタンスを強制します。しかし、コマンドラインでアプリを開始するとシステムのシングルインスタンスメカニズムは無視されるので、シングルインスタンスを強制するためには、このメソッドを使う必要があります。 +macOSは、ユーザーがFinderで2つ目のアプリインスタンスを開いたり、`open-file` 、 `open-url`イベントが出力しようとすると、システムが自動的にシングルインスタンスを強制します。しかし、コマンドラインでアプリを開始するとシステムのシングルインスタンスメカニズムは無視されるので、シングルインスタンスを強制するためには、このメソッドを使う必要があります。 2つ目のインスタンスを起動するとき、メインのインスタンスのウィンドウをアクティブにする例 @@ -392,7 +392,7 @@ Chromiumのコマンドダインに引数を追加します。引数は正しく **Note:** `process.argv`に影響しません。 -### `app.dock.bounce([type])` _OS X_ +### `app.dock.bounce([type])` _macOS_ * `type` String (optional) - `critical` または `informational`を指定できます。既定では、 `informational`です。 @@ -402,37 +402,37 @@ Chromiumのコマンドダインに引数を追加します。引数は正しく リクエストを示すIDを戻します。 -### `app.dock.cancelBounce(id)` _OS X_ +### `app.dock.cancelBounce(id)` _macOS_ * `id` Integer `id`のバウンスをキャンセルします。 -### `app.dock.setBadge(text)` _OS X_ +### `app.dock.setBadge(text)` _macOS_ * `text` String dockのバッジエリアで表示する文字列を設定します。 -### `app.dock.getBadge()` _OS X_ +### `app.dock.getBadge()` _macOS_ dockのバッジ文字列を戻します。 -### `app.dock.hide()` _OS X_ +### `app.dock.hide()` _macOS_ dock アイコンを隠します。 -### `app.dock.show()` _OS X_ +### `app.dock.show()` _macOS_ dock アイコンを表示します。 -### `app.dock.setMenu(menu)` _OS X_ +### `app.dock.setMenu(menu)` _macOS_ * `menu` Menu アプリケーションの[dock menu][dock-menu]を設定します。 -### `app.dock.setIcon(image)` _OS X_ +### `app.dock.setIcon(image)` _macOS_ * `image` [NativeImage](native-image.md) diff --git a/docs-translations/jp/api/auto-updater.md b/docs-translations/jp/api/auto-updater.md index 818a75e019a..92f1fce2197 100644 --- a/docs-translations/jp/api/auto-updater.md +++ b/docs-translations/jp/api/auto-updater.md @@ -6,9 +6,9 @@ `autoUpdater`は、異なるプラットフォーム用に統一したAPIを提供していますが、それぞれのプラットフォーム上で、まだ多少の差があります。 -### OS X +### macOS -OS Xでは、 `autoUpdater` モジュールは、[Squirrel.Mac][squirrel-mac]上に構築されていて、動作させるのに特別な設定が不要であることを意味します。サーバーサイドの要件は、[Server Support][server-support]を読んでください。 +macOSでは、 `autoUpdater` モジュールは、[Squirrel.Mac][squirrel-mac]上に構築されていて、動作させるのに特別な設定が不要であることを意味します。サーバーサイドの要件は、[Server Support][server-support]を読んでください。 ### Windows @@ -16,7 +16,7 @@ Windowsでは、auto-updaterを使う前に、ユーザーのPCにアプリを Squirrelで生成されたインストーラーは、`com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`のフォーマット（例えば、`com.squirrel.slack.Slack` と `com.squirrel.code.Code`）で[Application User Model ID][app-user-model-id]とショートカットアイコンを作成します。`app.setAppUserModelId`APIで同じIDを使う必要があります。同じIDでないと、Windowsはタスクバーに適切にピン止めすることができません。 -サーバーサイドのセットアップは、OS Xと異なります。詳細は、[Squirrel.Windows][squirrel-windows] を参照してください。 +サーバーサイドのセットアップは、macOSと異なります。詳細は、[Squirrel.Windows][squirrel-windows] を参照してください。 ### Linux diff --git a/docs-translations/jp/api/crash-reporter.md b/docs-translations/jp/api/crash-reporter.md index 50dbdf28d40..a1fb21f5111 100644 --- a/docs-translations/jp/api/crash-reporter.md +++ b/docs-translations/jp/api/crash-reporter.md @@ -37,7 +37,7 @@ crashReporter.start({ 他の`crashReporter`APIを使用する前にこのメソッドをコールする必要があります。 -**Note:** OS Xでは、Electronは、WindowsとLinux上の`breakpad` とは異なる、新しい`crashpad`クライアントを使用します。クラッシュ収集機能を有効にするために、メインプロセスや、クラッシュレポートを収集したいそれぞれのレンダラープロセスで、`crashpad`を初期化するために`crashReporter.start`APIをコールする必要があります。 +**Note:** macOSでは、Electronは、WindowsとLinux上の`breakpad` とは異なる、新しい`crashpad`クライアントを使用します。クラッシュ収集機能を有効にするために、メインプロセスや、クラッシュレポートを収集したいそれぞれのレンダラープロセスで、`crashpad`を初期化するために`crashReporter.start`APIをコールする必要があります。 ### `crashReporter.getLastCrashReport()` diff --git a/docs-translations/jp/api/dialog.md b/docs-translations/jp/api/dialog.md index c01fef3fa33..48a17225bb5 100644 --- a/docs-translations/jp/api/dialog.md +++ b/docs-translations/jp/api/dialog.md @@ -10,7 +10,7 @@ const dialog = require('electron').dialog; console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', 'multiSelections' ]})); ``` -**Note for OS X**: シートとしてダイアログを表示したい場合、唯一しなければならないことは、`browserWindow`パラメーターを参照する`BrowserWindow`を提供することです。 +**Note for macOS**: シートとしてダイアログを表示したい場合、唯一しなければならないことは、`browserWindow`パラメーターを参照する`BrowserWindow`を提供することです。 ## メソッド @@ -73,7 +73,7 @@ console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', ' * `message` String - メッセージボックスのコンテンツ。 * `detail` String - メッセージの外部情報 * `icon` [NativeImage](native-image.md) - * `cancelId` Integer - ダイアログのボタンをクリックする代わりにユーザーがダイアログをキャンセルしたときに返す値です。既定では、ラベルの "cancel"や"no"を持つボタンのインデックスまたは、そのようなボタンが無ければ0を返します。OS XやWindowsでは、 すでに指定されているかどうかは関係なく、"Cancel"ボタンのインデックスはいつでも `cancelId`が使われます。 + * `cancelId` Integer - ダイアログのボタンをクリックする代わりにユーザーがダイアログをキャンセルしたときに返す値です。既定では、ラベルの "cancel"や"no"を持つボタンのインデックスまたは、そのようなボタンが無ければ0を返します。macOSやWindowsでは、 すでに指定されているかどうかは関係なく、"Cancel"ボタンのインデックスはいつでも `cancelId`が使われます。 * `noLink` Boolean - Windowsでは、Electronは、 ("Cancel" または "Yes"のような)共通ボタンである`buttons`の一つを見つけようとし、ダイアログ内のコマンドリンクとして表示します。この挙動が気に入らない場合は、 `noLink` を `true`に設定できます。 * `callback` Function diff --git a/docs-translations/jp/api/frameless-window.md b/docs-translations/jp/api/frameless-window.md index 4478387877e..518e2680cf9 100644 --- a/docs-translations/jp/api/frameless-window.md +++ b/docs-translations/jp/api/frameless-window.md @@ -11,9 +11,9 @@ const BrowserWindow = require('electron').BrowserWindow; var win = new BrowserWindow({ width: 800, height: 600, frame: false }); ``` -### OS Xでの別の方法 +### macOSでの別の方法 -Mac OS X 10.10 Yosemite以降では、Chrome無しのウィンドウを指定する方法があります。`frame`を`false`に設定しタイトルバーとウィンドウコントロールの両方を無効にする代わりに、タイトルバーを隠しコンテンツをフルウィンドウサイズに広げたいけど、標準的なウィンドウ操作用にウィンドウコントロール("トラフィックライト")を維持したいかもしれません。新しい`titleBarStyle`オプションを指定することで、そうできます。 +macOS 10.10 Yosemite以降では、Chrome無しのウィンドウを指定する方法があります。`frame`を`false`に設定しタイトルバーとウィンドウコントロールの両方を無効にする代わりに、タイトルバーを隠しコンテンツをフルウィンドウサイズに広げたいけど、標準的なウィンドウ操作用にウィンドウコントロール("トラフィックライト")を維持したいかもしれません。新しい`titleBarStyle`オプションを指定することで、そうできます。 ```javascript var win = new BrowserWindow({ 'titleBarStyle': 'hidden' }); diff --git a/docs-translations/jp/api/menu-item.md b/docs-translations/jp/api/menu-item.md index 9e28582e622..4c42f73d7e4 100644 --- a/docs-translations/jp/api/menu-item.md +++ b/docs-translations/jp/api/menu-item.md @@ -38,7 +38,7 @@ * `minimize` - 現在のウィンドウの最小化 * `close` - 現在のウィンドウを閉じます -OS Xでは、`role`は次の追加の値を取れます: +macOSでは、`role`は次の追加の値を取れます: * `about` - `orderFrontStandardAboutPanel`動作に紐づけられます * `hide` - `hide`動作に紐づけられます diff --git a/docs-translations/jp/api/menu.md b/docs-translations/jp/api/menu.md index 12039b1d6ad..d39573b29ee 100644 --- a/docs-translations/jp/api/menu.md +++ b/docs-translations/jp/api/menu.md @@ -208,9 +208,9 @@ Menu.setApplicationMenu(menu); * `menu` Menu -OS Xで、アプリケーションメニューとして`menu`を設定します。WindowsとLinuxでは、`menu`はそれぞれのウィンドウの上のメニューとして設定されます。 +macOSで、アプリケーションメニューとして`menu`を設定します。WindowsとLinuxでは、`menu`はそれぞれのウィンドウの上のメニューとして設定されます。 -### `Menu.sendActionToFirstResponder(action)` _OS X_ +### `Menu.sendActionToFirstResponder(action)` _macOS_ * `action` String @@ -229,7 +229,7 @@ OS Xで、アプリケーションメニューとして`menu`を設定します * `browserWindow` BrowserWindow (オプション) - 既定では`null`です。 * `x` Number (オプション) - 既定では -1です。 * `y` Number (**必須** `x` が使われている場合) - 既定では -1です。 -* `positioningItem` Number (オプション) _OS X_ - 既定では -1です。 +* `positioningItem` Number (オプション) _macOS_ - 既定では -1です。 メニューアイテムのインデックスを指定した座標にマウスカーソルを配置します。 @@ -252,13 +252,13 @@ OS Xで、アプリケーションメニューとして`menu`を設定します メニューのアイテムを収容した配列を取得します。 -## OS X アプリケーションメニューの注意事項 +## macOS アプリケーションメニューの注意事項 -OS Xは、WindowsとLinuxのアプリケーションのメニューとは完全に異なるスタイルを持ち、よりネイティブのようにアプリメニューを作成するのに幾つかの注意事項があります。 +macOSは、WindowsとLinuxのアプリケーションのメニューとは完全に異なるスタイルを持ち、よりネイティブのようにアプリメニューを作成するのに幾つかの注意事項があります。 ### 標準的なメニュー -OS Xでは、`Services`と`Windows`メニューのように定義された標準的な多くのメニューがあります。標準的なメニューを作成するために、メニューの`role`に次のどれかを設定する必要があり、Electronはそれを受けて標準的なメニューを作成します。 +macOSでは、`Services`と`Windows`メニューのように定義された標準的な多くのメニューがあります。標準的なメニューを作成するために、メニューの`role`に次のどれかを設定する必要があり、Electronはそれを受けて標準的なメニューを作成します。 * `window` * `help` @@ -266,11 +266,11 @@ OS Xでは、`Services`と`Windows`メニューのように定義された標準 ### 標準的なメニューアイテムの動作 -`About xxx`と`Hide xxx`、`Hide Others`のようないくつかのメニューアイテム用にOS Xは標準的な動作を提供します。メニューアイテムの動作に標準的な動作を設定するために、メニューアイテムの`role`属性を設定すべきです。 +`About xxx`と`Hide xxx`、`Hide Others`のようないくつかのメニューアイテム用にmacOSは標準的な動作を提供します。メニューアイテムの動作に標準的な動作を設定するために、メニューアイテムの`role`属性を設定すべきです。 ### メインのメニュー名 -OS Xでは、設定したラベルに関係なく、アプリケーションの最初のアイテムのラベルはいつもアプリの名前です。変更するために、アプリにバンドルされている`Info.plist`ファイルを修正してアプリの名前を変更する必要があります。詳細は、 [About Information Property List Files][AboutInformationPropertyListFiles] を見てください。 +macOSでは、設定したラベルに関係なく、アプリケーションの最初のアイテムのラベルはいつもアプリの名前です。変更するために、アプリにバンドルされている`Info.plist`ファイルを修正してアプリの名前を変更する必要があります。詳細は、 [About Information Property List Files][AboutInformationPropertyListFiles] を見てください。 ## メニューアイテムの位置 diff --git a/docs-translations/jp/api/native-image.md b/docs-translations/jp/api/native-image.md index fa98eaed221..a819123707c 100644 --- a/docs-translations/jp/api/native-image.md +++ b/docs-translations/jp/api/native-image.md @@ -66,7 +66,7 @@ var appIcon = new Tray('/Users/somebody/images/icon.png'); もっとも一般的なケースは、ライトとダークなメニュバー両方に切り替え可能なメニュバーアイコン用にテンプレート画像を使います。 -**Note:** テンプレート画像は、OS Xでのみサポートしています。 +**Note:** テンプレート画像は、macOSでのみサポートしています。 テンプレート画像として画像をマークするために、ファイル名の最後に`Template`をつけます。 diff --git a/docs-translations/jp/api/process.md b/docs-translations/jp/api/process.md index 0f9d60f5a3a..23301494a37 100644 --- a/docs-translations/jp/api/process.md +++ b/docs-translations/jp/api/process.md @@ -72,7 +72,7 @@ Windows Store App (appx)として動作中の場合は、値は`true`になり このプロセスのメインスレッドをハングさせます。 -### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_ +### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs-translations/jp/api/tray.md b/docs-translations/jp/api/tray.md index 5c76e740530..a26f6c59741 100644 --- a/docs-translations/jp/api/tray.md +++ b/docs-translations/jp/api/tray.md @@ -63,9 +63,9 @@ __プラットフォームの制限:__ トレイアイコンがクリックされたときに出力されます。 -__Note:__ `バウンド` 再生はOS XとWindoesのみで実装されています。 +__Note:__ `バウンド` 再生はmacOSとWindoesのみで実装されています。 -### イベント: 'right-click' _OS X_ _Windows_ +### イベント: 'right-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -80,7 +80,7 @@ __Note:__ `バウンド` 再生はOS XとWindoesのみで実装されていま トレイアイコンが右クリックされると出力されます。 -### イベント: 'double-click' _OS X_ _Windows_ +### イベント: 'double-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -107,26 +107,26 @@ __Note:__ `バウンド` 再生はOS XとWindoesのみで実装されていま タイムアウトもしくはユーザーの操作で閉じて、トレイバルーンがクロースされたときに出力されます。 -### イベント: 'drop' _OS X_ +### イベント: 'drop' _macOS_ トレイアイコンでアイテムがドラグアンドドロップされたときに出力されます。 -### イベント: 'drop-files' _OS X_ +### イベント: 'drop-files' _macOS_ * `event` * `files` Array - ドロップされたアイテムのフルパス トレイアイコンでファイルがドロップされたときに出力されます。 -### イベント: 'drag-enter' _OS X_ +### イベント: 'drag-enter' _macOS_ トレイアイコンにドラッグ操作が入ったときに出力されます。 -### イベント: 'drag-leave' _OS X_ +### イベント: 'drag-leave' _macOS_ トレイアイコンででドラッグ操作が行われたときに出力されます。 -### イベント: 'drag-end' _OS X_ +### イベント: 'drag-end' _macOS_ トレイ上でドラッグ操作が終了したか、ほかの場所で終了したときに出力されます。 @@ -146,11 +146,11 @@ __Note:__ `バウンド` 再生はOS XとWindoesのみで実装されていま トレイアイコンの`image`を設定します。 -### `Tray.setPressedImage(image)` _OS X_ +### `Tray.setPressedImage(image)` _macOS_ * `image` [NativeImage](native-image.md) -OS Xで押されたときにトレイアイコンの`image`を設定します。 +macOSで押されたときにトレイアイコンの`image`を設定します。 ### `Tray.setToolTip(toolTip)` @@ -158,13 +158,13 @@ OS Xで押されたときにトレイアイコンの`image`を設定します。 トレイアイコン用のホバーテキストを設定します。 -### `Tray.setTitle(title)` _OS X_ +### `Tray.setTitle(title)` _macOS_ * `title` String ステータスバーで、トレイアイコンのわきに表示するタイトルを設定します。 -### `Tray.setHighlightMode(highlight)` _OS X_ +### `Tray.setHighlightMode(highlight)` _macOS_ * `highlight` Boolean @@ -179,7 +179,7 @@ OS Xで押されたときにトレイアイコンの`image`を設定します。 トレイバルーンを表示します。 -### `Tray.popUpContextMenu([menu, position])` _OS X_ _Windows_ +### `Tray.popUpContextMenu([menu, position])` _macOS_ _Windows_ * `menu` Menu (optional) * `position` Object (optional) - ポップアップ位置 diff --git a/docs-translations/jp/tutorial/application-distribution.md b/docs-translations/jp/tutorial/application-distribution.md index 19cc42979e1..43df2adb3de 100644 --- a/docs-translations/jp/tutorial/application-distribution.md +++ b/docs-translations/jp/tutorial/application-distribution.md @@ -1,9 +1,9 @@ # アプリケーションの配布 -Electronでアプリケーションを配布するために、アプリケーションを`app` という名前のディレクトリにし、Electronのリソースディレクトリ(OS X では +Electronでアプリケーションを配布するために、アプリケーションを`app` という名前のディレクトリにし、Electronのリソースディレクトリ(macOS では `Electron.app/Contents/Resources/` 、Linux と Windows では `resources/`)配下に置くべきです, -OS X: +macOS: ```text electron/Electron.app/Contents/Resources/app/ @@ -29,7 +29,7 @@ electron/resources/app `app` フォルダの代わりに `asar` アーカイブを使用するためには、アーカイブファイルを `app.asar` という名前に変更し、Electron のリソースディレクトリに以下のように配置する必要があります。すると、Electron はアーカイブを読み込もうとし、それを開始します。 -OS X: +macOS: ```text electron/Electron.app/Contents/Resources/ @@ -54,7 +54,7 @@ Electronにバンドルした後、ユーザーに配布する前に、 Electron `electron.exe`を任意の名前に変更でき、[rcedit](https://github.com/atom/rcedit) のようなツールでアイコンやその他の情報を編集できます。 -### OS X +### macOS `Electron.app` を任意の名前に変更でき、次のファイルの `CFBundleDisplayName`と `CFBundleIdentifier`、 `CFBundleName`のフィールドの名前を変更する必要があります。 diff --git a/docs-translations/jp/tutorial/desktop-environment-integration.md b/docs-translations/jp/tutorial/desktop-environment-integration.md index 6cd838afa7d..c6f7a585fbe 100644 --- a/docs-translations/jp/tutorial/desktop-environment-integration.md +++ b/docs-translations/jp/tutorial/desktop-environment-integration.md @@ -4,7 +4,7 @@ このガイドでは、Electron APIでデスクトップ環境にアプリケーションを統合する方法を説明します。 -## 通知 (Windows, Linux, OS X) +## 通知 (Windows, Linux, macOS) 3つのオペレーティングシステム全てで、アプリケーションからユーザーに通知を送る手段が提供されています。通知を表示するためにオペレーティングシステムのネイティブ通知APIを使用しする[HTML5 Notification API](https://notifications.spec.whatwg.org/)で、Electronは、開発者に通知を送ることができます。 @@ -36,15 +36,15 @@ Model ID][app-user-model-id]で、アプリへのショートカットはスタ 通知は、`libnotify`を使用して送信されます。[デスクトップ通知仕様][notification-spec]に対応したデスクトップ環境上（Cinnamon、Enlightenment、Unity、GNOME、KDEなど）で通知を表示できます。 -### OS X +### macOS -通知は、そのままOS Xに通知されます。しかし、[通知に関するAppleのヒューマンインターフェイスガイドライン（英語版）](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)を知っておくべきです。 +通知は、そのままmacOSに通知されます。しかし、[通知に関するAppleのヒューマンインターフェイスガイドライン（英語版）](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)を知っておくべきです。 通知は、256バイトサイズに制限されており、制限を超えていた場合、通知が破棄されます。 -## 最近のドキュメント (Windows と OS X) +## 最近のドキュメント (Windows と macOS) -Windows と OS Xは、ジャンプリストやドックメニュー経由で、アプリケーションが開いた最近のドキュメント一覧に簡単にアクセスできます。 +Windows と macOSは、ジャンプリストやドックメニュー経由で、アプリケーションが開いた最近のドキュメント一覧に簡単にアクセスできます。 __JumpList:__ @@ -72,19 +72,19 @@ Windows で、この機能を使用できるようにするために、アプリ ユーザーがジャンプリストからファイルをクリックしたとき、アプリケーションの新しいインスタンスは、コマンドライン引数にファイルのパスを渡して開始します。 -### OS X 留意点 +### macOS 留意点 ファイルが最近のドキュメントメニューからリクエストされた時、 `app` モジュールの `open-file` イベントが発行されます。 -## ドックメニュー (OS X)のカスタマイズ +## ドックメニュー (macOS)のカスタマイズ -通常アプリケーションで使用する共通機能用のショートカットを含める、ドック用のカスタムメニューをOS Xでは指定できます。 +通常アプリケーションで使用する共通機能用のショートカットを含める、ドック用のカスタムメニューをmacOSでは指定できます。 __Dock menu of Terminal.app:__ -カスタムドックメニューを設定するために、OS Xのみに提供されている `app.dock.setMenu` APIを使用できます。 +カスタムドックメニューを設定するために、macOSのみに提供されている `app.dock.setMenu` APIを使用できます。 ```javascript const electron = require('electron'); @@ -115,7 +115,7 @@ __Internet Explorerのタスク:__ ![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png) -実際のメニューであるOS Xのドックメニューとは異なり、ユーザーがタスクをクリックしたとき、Windowsではユーザータスクはアプリケーションのショートカットのように動作し、プログラムは指定された引数を実行します。 +実際のメニューであるmacOSのドックメニューとは異なり、ユーザーがタスクをクリックしたとき、Windowsではユーザータスクはアプリケーションのショートカットのように動作し、プログラムは指定された引数を実行します。 アプリケーション用のユーザータスクを設定するために、[app.setUserTasks][setusertaskstasks] APIを使用できます: @@ -192,11 +192,11 @@ __Audaciousのランチャーショートカット:__ ![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png) -## タスクバーの進行状況バー (Windows, OS X, Unity) +## タスクバーの進行状況バー (Windows, macOS, Unity) Windowsでは、タスクバーボタンは、進行状況バーを表示するのに使えます。ウィンドウを切り替えることなくウィンドウの進行状況情報をユーザーに提供することができます。 -OS Xではプログレスバーはドックアイコンの一部として表示されます。 +macOSではプログレスバーはドックアイコンの一部として表示されます。 Unity DEは、ランチャーに進行状況バーの表示をするのと同様の機能を持っています。 __タスクバーボタン上の進行状況バー:__ @@ -227,9 +227,9 @@ let win = new BrowserWindow({...}); win.setOverlayIcon('path/to/overlay.png', 'Description for overlay'); ``` -## Windowのファイル表示 (OS X) +## Windowのファイル表示 (macOS) -OS Xでは、ウィンドウがrepresented fileを設定でき、タイトルバー上にファイルのアイコンを表示でき、タイトル上でCommand-クリックまたはControl-クリックをすると、パスがポップアップ表示されます。 +macOSでは、ウィンドウがrepresented fileを設定でき、タイトルバー上にファイルのアイコンを表示でき、タイトル上でCommand-クリックまたはControl-クリックをすると、パスがポップアップ表示されます。 ウィンドウの編集状態を設定できるように、このウィンドウのドキュメントが変更されたかどうかをファイルのアイコンで示せます。 diff --git a/docs-translations/jp/tutorial/mac-app-store-submission-guide.md b/docs-translations/jp/tutorial/mac-app-store-submission-guide.md index fd42d55937d..f396de6091d 100644 --- a/docs-translations/jp/tutorial/mac-app-store-submission-guide.md +++ b/docs-translations/jp/tutorial/mac-app-store-submission-guide.md @@ -84,7 +84,7 @@ codesign -s "$APP_KEY" -f --entitlements parent.plist "$APP_PATH" productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH" ``` -OS Xでのアプリのサンドボックス化を行うことが初めてなら、Appleの[Enabling App Sandbox][enable-app-sandbox]を通読し、基本的な考え方を確認してから、、エンタイトルメントファイルにアプリに必要なパーミッションキーを追加します。 +macOSでのアプリのサンドボックス化を行うことが初めてなら、Appleの[Enabling App Sandbox][enable-app-sandbox]を通読し、基本的な考え方を確認してから、、エンタイトルメントファイルにアプリに必要なパーミッションキーを追加します。 ### Appをアップロードする。 diff --git a/docs-translations/jp/tutorial/quick-start.md b/docs-translations/jp/tutorial/quick-start.md index f6c5e9679f8..8bd24994b52 100644 --- a/docs-translations/jp/tutorial/quick-start.md +++ b/docs-translations/jp/tutorial/quick-start.md @@ -86,14 +86,14 @@ app.on('ready', createWindow); // すべてのウィンドウが閉じられた時にアプリケーションを終了する。 app.on('window-all-closed', () => { - // OS Xでは、Cmd + Q(終了)をユーザーが実行するまではウィンドウが全て閉じられても終了しないでおく。 + // macOSでは、Cmd + Q(終了)をユーザーが実行するまではウィンドウが全て閉じられても終了しないでおく。 if (process.platform !== 'darwin') { app.quit(); } }); app.on('activate', () => { - // OS X では、ドックをクリックされた時にウィンドウがなければ新しく作成する。 + // macOS では、ドックをクリックされた時にウィンドウがなければ新しく作成する。 if (win === null) { createWindow(); } @@ -157,7 +157,7 @@ $ .\electron\electron.exe your-app\ $ ./electron/electron your-app/ ``` -#### OS X +#### macOS ```bash $ ./Electron.app/Contents/MacOS/Electron your-app/ diff --git a/docs-translations/jp/tutorial/supported-platforms.md b/docs-translations/jp/tutorial/supported-platforms.md index 7d9f24b7ab6..07da250f1b9 100644 --- a/docs-translations/jp/tutorial/supported-platforms.md +++ b/docs-translations/jp/tutorial/supported-platforms.md @@ -2,9 +2,9 @@ Electronでは次のプラットフォームをサポートします。 -### OS X +### macOS -OS X用に提供しているバイナリは64bitのみで、サポートするOS Xのバージョンは、OS X 10.9 以降です。 +macOS用に提供しているバイナリは64bitのみで、サポートするmacOSのバージョンは、macOS 10.9 以降です。 ### Windows diff --git a/docs-translations/jp/tutorial/using-pepper-flash-plugin.md b/docs-translations/jp/tutorial/using-pepper-flash-plugin.md index 8f0b56e1050..85a896f8cc3 100644 --- a/docs-translations/jp/tutorial/using-pepper-flash-plugin.md +++ b/docs-translations/jp/tutorial/using-pepper-flash-plugin.md @@ -5,7 +5,7 @@ Electronは、Pepper Flashプラグインをサポートしています。Electr ## Flash プラグインのコピー準備 -OS XとLinuxでは、Pepper Flashプラグインの詳細は、Chromeブラウザーで、`chrome://plugins` にアクセスして確認できます。そこで表示されるパスとバージョンは、ElectronのPepper Flashサポートに役立ちます。それを別のパスにコピーすることができます。 +macOSとLinuxでは、Pepper Flashプラグインの詳細は、Chromeブラウザーで、`chrome://plugins` にアクセスして確認できます。そこで表示されるパスとバージョンは、ElectronのPepper Flashサポートに役立ちます。それを別のパスにコピーすることができます。 ## Electron スイッチの追加 @@ -16,7 +16,7 @@ OS XとLinuxでは、Pepper Flashプラグインの詳細は、Chromeブラウ ```javascript // Specify flash path. // On Windows, it might be /path/to/pepflashplayer.dll -// On OS X, /path/to/PepperFlashPlayer.plugin +// On macOS, /path/to/PepperFlashPlayer.plugin // On Linux, /path/to/libpepflashplayer.so app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so'); diff --git a/docs-translations/jp/tutorial/using-widevine-cdm-plugin.md b/docs-translations/jp/tutorial/using-widevine-cdm-plugin.md index 7c3b7677144..f8839182e5b 100644 --- a/docs-translations/jp/tutorial/using-widevine-cdm-plugin.md +++ b/docs-translations/jp/tutorial/using-widevine-cdm-plugin.md @@ -8,13 +8,13 @@ Electronは、ライセンス的な理由でWidevine CDMプラグインは同梱 __Note:__ Chromeブラウザのメジャーバージョンは、Electronが使用するChromeバージョンと同じでなければなりません。そうでなければ、プラグインは、`navigator.plugins`経由でロードされて表示されるにも関わらず動作しません。 -### Windows & OS X +### Windows & macOS Chromeブラウザーで、`chrome://components/`を開き、 `WidevineCdm` を探し、それが最新であることを確認し、`APP_DATA/Google/Chrome/WidevineCDM/VERSION/_platform_specific/PLATFORM_ARCH/`ディレクトリからすべてのプラグインバイナリを探します。 -`APP_DATA` は、アプリデータを格納するシステムロケーションです。Windowsでは`%LOCALAPPDATA%`、OS Xでは`~/Library/Application Support`です。`VERSION` は、Widevine CDM プラグインのバージョン文字列で、 `1.4.8.866`のような文字列が格納されます。`PLATFORM` は、 `mac` か `win`です。`ARCH` は `x86` か `x64`です。 +`APP_DATA` は、アプリデータを格納するシステムロケーションです。Windowsでは`%LOCALAPPDATA%`、macOSでは`~/Library/Application Support`です。`VERSION` は、Widevine CDM プラグインのバージョン文字列で、 `1.4.8.866`のような文字列が格納されます。`PLATFORM` は、 `mac` か `win`です。`ARCH` は `x86` か `x64`です。 -Windowsでは、`widevinecdm.dll` と `widevinecdmadapter.dll`が必要で、OS Xでは、`libwidevinecdm.dylib` と `widevinecdmadapter.plugin`です。任意の場所にコピーできますが、一緒に配置する必要があります。 +Windowsでは、`widevinecdm.dll` と `widevinecdmadapter.dll`が必要で、macOSでは、`libwidevinecdm.dylib` と `widevinecdmadapter.plugin`です。任意の場所にコピーできますが、一緒に配置する必要があります。 ### Linux @@ -32,7 +32,7 @@ __Note:__ `widevinecdmadapter` バイナリはElectronにパスが通ってい ```javascript // You have to pass the filename of `widevinecdmadapter` here, it is -// * `widevinecdmadapter.plugin` on OS X, +// * `widevinecdmadapter.plugin` on macOS, // * `libwidevinecdmadapter.so` on Linux, // * `widevinecdmadapter.dll` on Windows. app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin'); diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index cd4ccb997a2..b522b06f97a 100644 --- a/docs-translations/ko-KR/README.md +++ b/docs-translations/ko-KR/README.md @@ -93,7 +93,7 @@ Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기 * [소스 코드 디렉터리 구조](development/source-code-directory-structure.md) * [NW.js(node-webkit)와 기술적으로 다른점](development/atom-shell-vs-node-webkit.md) * [빌드 시스템 개요](development/build-system-overview.md) -* [빌드 설명서 (OS X)](development/build-instructions-osx.md) +* [빌드 설명서 (macOS)](development/build-instructions-osx.md) * [빌드 설명서 (Windows)](development/build-instructions-windows.md) * [빌드 설명서 (Linux)](development/build-instructions-linux.md) * [디버그 설명서 (Windows)](development/debug-instructions-windows.md) diff --git a/docs-translations/ko-KR/api/accelerator.md b/docs-translations/ko-KR/api/accelerator.md index 05532d06c08..19302774930 100644 --- a/docs-translations/ko-KR/api/accelerator.md +++ b/docs-translations/ko-KR/api/accelerator.md @@ -12,13 +12,13 @@ Accelerator는 `+` 문자를 통해 여러 혼합키와 키코드를 결합할 ## 플랫폼에 관련하여 주의할 점 Linux와 Windows에서는 `Command`키가 없으므로 작동하지 않습니다. 대신에 -`CommandOrControl`을 사용하면 OS X의 `Command`와 Linux, Windows의 `Control` 모두 +`CommandOrControl`을 사용하면 macOS의 `Command`와 Linux, Windows의 `Control` 모두 지원할 수 있습니다. -`Option` 대신 `Alt`을 사용하는게 좋습니다. `Option` 키는 OS X에만 있으므로 +`Option` 대신 `Alt`을 사용하는게 좋습니다. `Option` 키는 macOS에만 있으므로 모든 플랫폼에서 사용할 수 있는 `Alt` 키를 권장합니다. -`Super`키는 Windows와 Linux 에서는 `윈도우`키를, OS X에서는 `Cmd`키로 맵핑됩니다. +`Super`키는 Windows와 Linux 에서는 `윈도우`키를, macOS에서는 `Cmd`키로 맵핑됩니다. ## 사용 가능한 혼합키 diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index 40c5194501d..96dac6951db 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/docs-translations/ko-KR/api/app.md @@ -19,7 +19,7 @@ app.on('window-all-closed', () => { 애플리케이션이 기본적인 시작 준비를 마치면 발생하는 이벤트입니다. Windows, Linux 운영체제에서의 `will-finish-launching` 이벤트는 `ready` 이벤트와 -동일합니다. OS X에서의 이벤트는 `NSApplication`의 +동일합니다. macOS에서의 이벤트는 `NSApplication`의 `applicationWillFinishLaunching`에 대한 알림으로 표현됩니다. 대개 이곳에서 `open-file`과 `open-url` 이벤트 리스너를 설정하고 crash reporter와 auto updater를 시작합니다. @@ -76,7 +76,7 @@ Returns: 애플리케이션이 종료될 때 발생하는 이벤트입니다. -### Event: 'open-file' _OS X_ +### Event: 'open-file' _macOS_ Returns: @@ -95,7 +95,7 @@ Returns: Windows에선 `process.argv` (메인 프로세스에서)를 통해 파일 경로를 얻을 수 있습니다. -### Event: 'open-url' _OS X_ +### Event: 'open-url' _macOS_ Returns: @@ -108,7 +108,7 @@ Returns: 이 이벤트를 처리할 땐 반드시 `event.preventDefault()`를 호출해야 합니다. -### Event: 'activate' _OS X_ +### Event: 'activate' _macOS_ Returns: @@ -118,7 +118,7 @@ Returns: 애플리케이션이 활성화 되었을 때 발생하는 이벤트입니다. 이 이벤트는 사용자가 애플리케이션의 dock 아이콘을 클릭했을 때 주로 발생합니다. -### Event: 'continue-activity' _OS X_ +### Event: 'continue-activity' _macOS_ Returns: @@ -308,14 +308,14 @@ app.exit(0) ### `app.focus()` -Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에선, 애플리케이션을 활성화 +Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. macOS에선, 애플리케이션을 활성화 앱 상태로 만듭니다. Windows에선, 애플리케이션의 첫 윈도우에 포커스 됩니다. -### `app.hide()` _OS X_ +### `app.hide()` _macOS_ 최소화를 하지 않고 애플리케이션의 모든 윈도우들을 숨깁니다. -### `app.show()` _OS X_ +### `app.show()` _macOS_ 숨긴 애플리케이션 윈도우들을 다시 보이게 만듭니다. 자동으로 포커스되지 않습니다. @@ -338,7 +338,7 @@ Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에 * `appData` - 각 사용자의 애플리케이션 데이터 디렉터리. 기본 경로는 다음과 같습니다: * `%APPDATA%` - Windows * `$XDG_CONFIG_HOME` 또는 `~/.config` - Linux - * `~/Library/Application Support` - OS X + * `~/Library/Application Support` - macOS * `userData` - 애플리케이션의 설정을 저장하는 디렉터리. 이 디렉터리는 기본적으로 `appData`에 애플리케이션 이름으로 생성된 폴더가 지정됩니다. * `temp` - 임시 폴더 디렉터리. @@ -399,20 +399,20 @@ npm 모듈 규칙에 따라 대부분의 경우 `package.json`의 `name` 필드 **참고:** Windows에선 `ready` 이벤트가 발생한 이후에 이 메서드를 호출해야 합니다. -### `app.addRecentDocument(path)` _OS X_ _Windows_ +### `app.addRecentDocument(path)` _macOS_ _Windows_ * `path` String 최근 문서 목록에 `path`를 추가합니다. 이 목록은 OS에 의해 관리됩니다. 최근 문서 목록은 Windows의 경우 작업 표시줄에서 찾을 -수 있고, OS X의 경우 dock 메뉴에서 찾을 수 있습니다. +수 있고, macOS의 경우 dock 메뉴에서 찾을 수 있습니다. -### `app.clearRecentDocuments()` _OS X_ _Windows_ +### `app.clearRecentDocuments()` _macOS_ _Windows_ 최근 문서 목록을 모두 비웁니다. -### `app.setAsDefaultProtocolClient(protocol)` _OS X_ _Windows_ +### `app.setAsDefaultProtocolClient(protocol)` _macOS_ _Windows_ * `protocol` String - 프로토콜의 이름, `://` 제외. 만약 앱을 통해 `electron://`과 같은 링크를 처리하고 싶다면, 이 메서드에 `electron` 인수를 담아 호출하면 됩니다. @@ -422,29 +422,29 @@ npm 모듈 규칙에 따라 대부분의 경우 `package.json`의 `name` 필드 `your-protocol://`과 같은 모든 링크에 대해 호출시 현재 실행 파일이 실행됩니다. 모든 링크, 프로토콜을 포함하여 애플리케이션의 인수로 전달됩니다. -**참고:** OS X에선, 애플리케이션의 `info.plist`에 등록해둔 프로토콜만 사용할 수 +**참고:** macOS에선, 애플리케이션의 `info.plist`에 등록해둔 프로토콜만 사용할 수 있습니다. 이는 런타임에서 변경될 수 없습니다. 이 파일은 간단히 텍스트 에디터를 사용하거나, 애플리케이션을 빌드할 때 스크립트가 생성되도록 할 수 있습니다. 자세한 내용은 [Apple의 참조 문서][CFBundleURLTypes]를 확인하세요. 이 API는 내부적으로 Windows 레지스트리와 LSSetDefaultHandlerForURLScheme를 사용합니다. -### `app.removeAsDefaultProtocolClient(protocol)` _OS X_ _Windows_ +### `app.removeAsDefaultProtocolClient(protocol)` _macOS_ _Windows_ * `protocol` String - 프로토콜의 이름, `://` 제외. 이 메서드는 현재 실행파일이 지정한 프로토콜(URI scheme)에 대해 기본 핸들러인지를 확인합니다. 만약 그렇다면, 이 메서드는 앱을 기본 핸들러에서 제거합니다. -### `app.isDefaultProtocolClient(protocol)` _OS X_ _Windows_ +### `app.isDefaultProtocolClient(protocol)` _macOS_ _Windows_ * `protocol` String - `://`를 제외한 프로토콜의 이름. 이 메서드는 현재 실행 파일이 지정한 프로토콜에 대해 기본 동작인지 확인합니다. (URI 스킴) 만약 그렇다면 `true`를 반환하고 아닌 경우 `false`를 반환합니다. -**참고:** OS X에선, 응용 프로그램이 프로토콜에 대한 기본 프로토콜 동작으로 -등록되었는지를 확인하기 위해 이 메서드를 사용할 수 있습니다. 또한 OS X에서 +**참고:** macOS에선, 응용 프로그램이 프로토콜에 대한 기본 프로토콜 동작으로 +등록되었는지를 확인하기 위해 이 메서드를 사용할 수 있습니다. 또한 macOS에서 `~/Library/Preferences/com.apple.LaunchServices.plist`를 확인하여 검증할 수도 있습니다. 자세한 내용은 [Apple의 참조 문서][LSCopyDefaultHandlerForURLScheme]를 참고하세요. @@ -494,10 +494,10 @@ Windows에서 사용할 수 있는 JumpList의 [Tasks][tasks] 카테고리에 `t 경우 `true`를 반환합니다. (다른 인스턴스에 인수가 전달됬을 때) 이 불리언 값을 통해 중복 생성된 인스턴스는 즉시 종료시켜야 합니다. -OS X에선 사용자가 Finder에서 애플리케이션의 두 번째 인스턴스를 열려고 했을 때 자동으로 +macOS에선 사용자가 Finder에서 애플리케이션의 두 번째 인스턴스를 열려고 했을 때 자동으로 **Single Instance** 화 하고 `open-file`과 `open-url` 이벤트를 발생시킵니다. 그러나 사용자가 애플리케이션을 CLI 터미널에서 실행하면 운영체제 시스템의 싱글 인스턴스 -메커니즘이 무시되며 그대로 중복 실행됩니다. 따라서 OS X에서도 이 메서드를 통해 확실히 +메커니즘이 무시되며 그대로 중복 실행됩니다. 따라서 macOS에서도 이 메서드를 통해 확실히 중복 실행을 방지하는 것이 좋습니다. 다음 예시는 두 번째 인스턴스가 생성되었을 때 중복된 인스턴스를 종료하고 주 애플리케이션 @@ -530,7 +530,7 @@ app.on('ready', () => { 모든 `makeSingleInstance`에 의해 생성된 제한을 해제합니다. 이 메서드는 다시 여러 인스턴스의 애플리케이션이 나란히 실행될 수 있도록 합니다. -### `app.setUserActivity(type, userInfo[, webpageURL])` _OS X_ +### `app.setUserActivity(type, userInfo[, webpageURL])` _macOS_ * `type` String - 고유하게 activity를 식별합니다. [`NSUserActivity.activityType`][activity-type]을 맵핑합니다. @@ -541,7 +541,7 @@ app.on('ready', () => { `NSUserActivity`를 만들고 현재 activity에 설정합니다. 이 activity는 이후 다른 기기와 [Handoff][handoff]할 때 자격으로 사용됩니다. -### `app.getCurrentActivityType()` _OS X_ +### `app.getCurrentActivityType()` _macOS_ 현재 작동중인 activity의 타입을 반환합니다. @@ -583,7 +583,7 @@ Chrominum의 명령줄에 인수를 추가합니다. 인수는 올바르게 인 **참고:** 이 메서드는 `process.argv`에 영향을 주지 않습니다. -### `app.dock.bounce([type])` _OS X_ +### `app.dock.bounce([type])` _macOS_ * `type` String (optional) - `critical` 또는 `informational`을 지정할 수 있습니다. 기본값은 `informational` 입니다. @@ -596,43 +596,43 @@ Chrominum의 명령줄에 인수를 추가합니다. 인수는 올바르게 인 또한 요청을 취소할 때 사용할 수 있는 ID를 반환합니다. -### `app.dock.cancelBounce(id)` _OS X_ +### `app.dock.cancelBounce(id)` _macOS_ * `id` Integer `app.dock.bounce([type])` 메서드에서 반환한 `id`의 바운스 효과를 취소합니다. -### `app.dock.downloadFinished(filePath)` _OS X_ +### `app.dock.downloadFinished(filePath)` _macOS_ * `filePath` String `filePath`가 다운로드 폴더에 들어있다면 다운로드 스택을 바운스합니다. -### `app.dock.setBadge(text)` _OS X_ +### `app.dock.setBadge(text)` _macOS_ * `text` String dock의 badge에 표시할 문자열을 설정합니다. -### `app.dock.getBadge()` _OS X_ +### `app.dock.getBadge()` _macOS_ dock의 badge에 설정된 문자열을 반환합니다. -### `app.dock.hide()` _OS X_ +### `app.dock.hide()` _macOS_ dock 아이콘을 숨깁니다. -### `app.dock.show()` _OS X_ +### `app.dock.show()` _macOS_ dock 아이콘을 표시합니다. -### `app.dock.setMenu(menu)` _OS X_ +### `app.dock.setMenu(menu)` _macOS_ * `menu` [Menu](menu.md) 애플리케이션의 [dock menu][dock-menu]를 설정합니다. -### `app.dock.setIcon(image)` _OS X_ +### `app.dock.setIcon(image)` _macOS_ * `image` [NativeImage](native-image.md) diff --git a/docs-translations/ko-KR/api/auto-updater.md b/docs-translations/ko-KR/api/auto-updater.md index 67a9c24dfdb..6cae78f88a6 100644 --- a/docs-translations/ko-KR/api/auto-updater.md +++ b/docs-translations/ko-KR/api/auto-updater.md @@ -21,13 +21,13 @@ Squirrel.Mac 와 Squirrel.Windows를 위한 간단한 node.js 기반 서버입 `autoUpdater`는 기본적으로 모든 플랫폼에 대해 같은 API를 제공하지만, 여전히 플랫폼별로 약간씩 다른 점이 있습니다. -### OS X +### macOS -OS X에선 `auto-updater` 모듈이 [Squirrel.Mac][squirrel-mac]를 기반으로 작동합니다. +macOS에선 `auto-updater` 모듈이 [Squirrel.Mac][squirrel-mac]를 기반으로 작동합니다. 따라서 이 모듈을 작동시키기 위해 특별히 준비해야 할 작업은 없습니다. 서버 사이드 요구 사항은 [서버 지원][server-support]을 참고하세요. -**참고:** Mac OS X에서 자동 업데이트를 지원하려면 반드시 사인이 되어있어야 합니다. +**참고:** macOS에서 자동 업데이트를 지원하려면 반드시 사인이 되어있어야 합니다. 이것은 `Squirrel.Mac`의 요구 사항입니다. ### Windows @@ -47,7 +47,7 @@ Squirrel로 생성된 인스톨러는 [Application User Model ID][app-user-model `app.setAppUserModelId` API를 통해 애플리케이션 ID를 동일하게 유지해야 합니다. 그렇지 않으면 Windows 작업 표시줄에 애플리케이션을 고정할 때 제대로 적용되지 않을 수 있습니다. -서버 사이드 요구 사항 또한 OS X와 다르게 적용됩니다. 자세한 내용은 +서버 사이드 요구 사항 또한 macOS와 다르게 적용됩니다. 자세한 내용은 [Squirrel.Windows][squirrel-windows]를 참고하세요. ### Linux @@ -98,7 +98,7 @@ Returns: ### `autoUpdater.setFeedURL(url[, requestHeaders])` * `url` String -* `requestHeaders` Object _OS X_ - HTTP 요청 헤더. +* `requestHeaders` Object _macOS_ - HTTP 요청 헤더. `url`을 설정하고 자동 업데이터를 초기화합니다. diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 947b7443132..4b5fd86cdc9 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -61,10 +61,10 @@ win.show(); * `alwaysOnTop` Boolean - 윈도우이 언제나 다른 창들 위에 유지되는지 여부. 기본값은 `false`입니다. * `fullscreen` Boolean - 윈도우의 전체화면 활성화 여부. 이 속성을 명시적으로 - `false`로 지정했을 경우, OS X에선 전체화면 버튼이 숨겨지거나 비활성됩니다. 기본값은 + `false`로 지정했을 경우, macOS에선 전체화면 버튼이 숨겨지거나 비활성됩니다. 기본값은 `false` 입니다. * `fullscreenable` Boolean - 윈도우가 전체화면 모드로 전환될 수 있는지 여부입니다. - 또한 OS X에선, 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 실행할지 여부도 + 또한 macOS에선, 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 실행할지 여부도 포함됩니다. 기본값은 `true`입니다. * `skipTaskbar` Boolean - 작업표시줄 애플리케이션 아이콘 표시 스킵 여부. 기본값은 `false`입니다. @@ -92,16 +92,16 @@ On Windows it is * `backgroundColor` String - `#66CD00` 와 `#FFF`, `#80FFFFFF` (알파 지원됨) 같이 16진수로 표현된 윈도우의 배경 색. 기본값은 `#FFF` (white). * `hasShadow` Boolean - 윈도우가 그림자를 가질지 여부를 지정합니다. 이 속성은 - OS X에서만 구현되어 있습니다. 기본값은 `true`입니다. + macOS에서만 구현되어 있습니다. 기본값은 `true`입니다. * `darkTheme` Boolean - 설정에 상관 없이 무조건 어두운 윈도우 테마를 사용합니다. 몇몇 GTK+3 데스크톱 환경에서만 작동합니다. 기본값은 `false`입니다. * `transparent` Boolean - 윈도우를 [투명화](frameless-window.md)합니다. 기본값은 `false`입니다. * `type` String - 특정 플랫폼에만 적용되는 윈도우의 종류를 지정합니다. 기본값은 일반 윈도우 입니다. 사용할 수 있는 창의 종류는 아래를 참고하세요. -* `standardWindow` Boolean - OS X의 표준 윈도우를 텍스쳐 윈도우 대신 사용합니다. +* `standardWindow` Boolean - macOS의 표준 윈도우를 텍스쳐 윈도우 대신 사용합니다. 기본 값은 `true`입니다. -* `titleBarStyle` String, OS X - 윈도우 타이틀 바 스타일을 지정합니다. 자세한 사항은 +* `titleBarStyle` String, macOS - 윈도우 타이틀 바 스타일을 지정합니다. 자세한 사항은 아래를 참고하세요. * `webPreferences` Object - 웹 페이지 기능을 설정합니다. 사용할 수 있는 속성은 아래를 참고하세요. @@ -114,14 +114,14 @@ On Windows it is * Linux의 경우, `desktop`, `dock`, `toolbar`, `splash`, `notification` 종류를 사용할 수 있습니다. -* OS X의 경우, `desktop`, `textured` 종류를 사용할 수 있습니다. +* macOS의 경우, `desktop`, `textured` 종류를 사용할 수 있습니다. * `textured`는 창에 메탈 그라디언트 외관(`NSTexturedBackgroundWindowMask`)을 설정합니다. * `desktop`은 데스크탑 배경 레벨(`kCGDesktopWindowLevel - 1`)에 윈도우를 배치합니다. 참고로 이렇게 만들어진 윈도우는 포커스, 키보드, 마우스 이벤트를 받을 수 없습니다. 하지만 편법으로 `globalShortcut`을 통해 키 입력을 받을 수 있습니다. -`titleBarStyle` 속성은 OS X 10.10 Yosemite 이후 버전만 지원하며, 다음 3가지 종류의 +`titleBarStyle` 속성은 macOS 10.10 Yosemite 이후 버전만 지원하며, 다음 3가지 종류의 값을 사용할 수 있습니다: * `default` 또는 미지정: 표준 Mac 회색 불투명 스타일을 사용합니다. @@ -174,7 +174,7 @@ On Windows it is 활성화합니다. 기본값은 `false`입니다. * `directWrite` Boolean - Windows에서 폰트 렌더링을 위해 DirectWrite를 사용하는지를 지정합니다. 기본값은 `true`입니다. -* `scrollBounce` Boolean - OS X에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다. +* `scrollBounce` Boolean - macOS에서 스크롤 튕기기 효과 (탄성 밴딩)를 활성화 합니다. 기본값은 `false`입니다. * `blinkFeatures` String - 활성화 할 `CSSVariables,KeyboardEventKey`같이 `,`로 구분된 기능 문자열들의 리스트입니다. [RuntimeEnabledFeatures.in][blink-feature-string] @@ -289,9 +289,9 @@ window.onbeforeunload = (e) => { 윈도우가 새로운 위치로 이동될 때 발생하는 이벤트입니다. -__참고__: OS X에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias)으로 사용됩니다. +__참고__: macOS에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias)으로 사용됩니다. -### Event: 'moved' _OS X_ +### Event: 'moved' _macOS_ 윈도우가 새로운 위치로 이동되었을 때 발생하는 이벤트입니다. (한 번만) @@ -336,15 +336,15 @@ someWindow.on('app-command', (e, cmd) => { }); ``` -### Event: 'scroll-touch-begin' _OS X_ +### Event: 'scroll-touch-begin' _macOS_ 스크롤 휠 이벤트가 동작하기 시작했을 때 발생하는 이벤트입니다. -### Event: 'scroll-touch-end' _OS X_ +### Event: 'scroll-touch-end' _macOS_ 스크롤 휠 이벤트가 동작을 멈췄을 때 발생하는 이벤트입니다. -### Event: 'swipe' _OS X_ +### Event: 'swipe' _macOS_ Returns: @@ -507,7 +507,7 @@ let win = new BrowserWindow({width: 800, height: 600}); 윈도우가 전체화면 모드 상태인지 여부를 반환합니다. -### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_ +### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_ * `aspectRatio` 유지하려 하는 콘텐츠 뷰 일부의 종횡비 * `extraSize` Object (optional) - 종횡비를 유지하는 동안 포함되지 않을 엑스트라 크기. @@ -535,7 +535,7 @@ let win = new BrowserWindow({width: 800, height: 600}); * `width` Integer * `height` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ 윈도우를 지정한 `width`, `height`, `x`, `y`로 크기 재조정 및 이동합니다. @@ -547,7 +547,7 @@ let win = new BrowserWindow({width: 800, height: 600}); * `width` Integer * `height` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ `width`와 `height` 값으로 윈도우 크기를 재조정합니다. (너비, 높이) @@ -559,7 +559,7 @@ let win = new BrowserWindow({width: 800, height: 600}); * `width` Integer * `height` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ 윈도우 클라이언트 영역(웹 페이지)의 크기를 `width`, `height`로 재조정합니다. @@ -599,38 +599,38 @@ let win = new BrowserWindow({width: 800, height: 600}); 사용자에 의해 윈도우의 크기가 재조정될 수 있는지 여부를 반환합니다. -### `win.setMovable(movable)` _OS X_ _Windows_ +### `win.setMovable(movable)` _macOS_ _Windows_ * `movable` Boolean 사용자에 의해 윈도우를 이동시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도 일어나지 않습니다. -### `win.isMovable()` _OS X_ _Windows_ +### `win.isMovable()` _macOS_ _Windows_ 사용자에 의해 윈도우를 이동시킬 수 있는지 여부를 반환합니다. Linux에선 항상 `true`를 반환합니다. -### `win.setMinimizable(minimizable)` _OS X_ _Windows_ +### `win.setMinimizable(minimizable)` _macOS_ _Windows_ * `minimizable` Boolean 사용자에 의해 윈도우를 최소화시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도 일어나지 않습니다. -### `win.isMinimizable()` _OS X_ _Windows_ +### `win.isMinimizable()` _macOS_ _Windows_ 사용자에 의해 윈도우를 최소화시킬 수 있는지 여부를 반환합니다. Linux에선 항상 `true`를 반환합니다. -### `win.setMaximizable(maximizable)` _OS X_ _Windows_ +### `win.setMaximizable(maximizable)` _macOS_ _Windows_ * `maximizable` Boolean 사용자에 의해 윈도우를 최대화시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도 일어나지 않습니다. -### `win.isMaximizable()` _OS X_ _Windows_ +### `win.isMaximizable()` _macOS_ _Windows_ 사용자에 의해 윈도우를 최대화시킬 수 있는지 여부를 반환합니다. Linux에선 항상 `true`를 반환합니다. @@ -647,14 +647,14 @@ let win = new BrowserWindow({width: 800, height: 600}); 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 토글할 수 있게 할지 여부를 반환합니다. -### `win.setClosable(closable)` _OS X_ _Windows_ +### `win.setClosable(closable)` _macOS_ _Windows_ * `closable` Boolean 사용자에 의해 윈도우가 수동적으로 닫힐 수 있는지 여부를 지정합니다. Linux에선 아무 일도 일어나지 않습니다. -### `win.isClosable()` _OS X_ _Windows_ +### `win.isClosable()` _macOS_ _Windows_ 사용자에 의해 윈도우가 수동적으로 닫힐 수 있는지 여부를 반환합니다. Linux에선 항상 `true`를 반환합니다. @@ -678,7 +678,7 @@ let win = new BrowserWindow({width: 800, height: 600}); * `x` Integer * `y` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ 윈도우의 위치를 `x`, `y`로 이동합니다. @@ -698,9 +698,9 @@ let win = new BrowserWindow({width: 800, height: 600}); **참고:** 웹 페이지의 제목과 네이티브 윈도우의 제목은 서로 다를 수 있습니다. -### `win.setSheetOffset(offsetY[, offsetX])` _OS X_ +### `win.setSheetOffset(offsetY[, offsetX])` _macOS_ -Mac OS X에서 시트를 부착할 위치를 지정합니다. 기본적으로 시트는 윈도우의 프레임 바로 +macOS에서 시트를 부착할 위치를 지정합니다. 기본적으로 시트는 윈도우의 프레임 바로 아래의 위치에 부착됩니다. 아마도 이 기능은 보통 다음과 같이 HTML 렌더링된 툴바 밑에 표시하기 위해 사용할 것입니다: @@ -735,7 +735,7 @@ Kiosk(키오스크) 모드를 설정합니다. `Buffer` 상의 플랫폼에 따른 윈도우 핸들을 반환합니다. -핸들의 타입에 따라 적절히 캐스팅됩니다. Windows의 `HWND`, OS X의 `NSView*`, Linux의 +핸들의 타입에 따라 적절히 캐스팅됩니다. Windows의 `HWND`, macOS의 `NSView*`, Linux의 `Window` (`unsigned long`)를 예로 들 수 있습니다. ### `win.hookWindowMessage(message, callback)` _Windows_ @@ -762,24 +762,24 @@ Windows 메시지 훅을 등록합니다. `callback`은 WndProc에서 메시지 모든 메시지 훅을 등록 해제합니다. -### `win.setRepresentedFilename(filename)` _OS X_ +### `win.setRepresentedFilename(filename)` _macOS_ * `filename` String 윈도우 대표 파일의 경로명을 설정합니다. 파일의 아이콘이 윈도우 타이틀 바에 표시됩니다. -### `win.getRepresentedFilename()` _OS X_ +### `win.getRepresentedFilename()` _macOS_ 윈도우 대표 파일의 경로명을 반환합니다. -### `win.setDocumentEdited(edited)` _OS X_ +### `win.setDocumentEdited(edited)` _macOS_ * `edited` Boolean 윈도우의 문서가 변경되었는지 여부를 설정합니다. 그리고 `true`로 설정했을 때 타이틀 바의 아이콘이 회색으로 표시됩니다. -### `win.isDocumentEdited()` _OS X_ +### `win.isDocumentEdited()` _macOS_ 윈도우의 문서가 변경되었는지 여부를 반환합니다. @@ -837,14 +837,14 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고 현재 작업표시줄 아이콘에 16 x 16 픽셀 크기의 오버레이를 지정합니다. 보통 이 기능은 애플리케이션의 여러 상태를 사용자에게 소극적으로 알리기 위한 방법으로 사용됩니다. -### `win.setHasShadow(hasShadow)` _OS X_ +### `win.setHasShadow(hasShadow)` _macOS_ * `hasShadow` (Boolean) 윈도우가 그림자를 가질지 여부를 지정합니다. Windows와 Linux에선 아무 일도 일어나지 않습니다. -### `win.hasShadow()` _OS X_ +### `win.hasShadow()` _macOS_ 윈도우가 그림자를 가지고 있는지 여부를 반환합니다. Windows와 Linux에선 항상 `true`를 반환합니다. @@ -879,7 +879,7 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고 눌려지지 않은 상태를 유지합니다. 이 값은 버튼을 알림의 용도로 사용하기 위해 만들어졌습니다. -### `win.showDefinitionForSelection()` _OS X_ +### `win.showDefinitionForSelection()` _macOS_ `webContents.showDefinitionForSelection()`와 같습니다. diff --git a/docs-translations/ko-KR/api/crash-reporter.md b/docs-translations/ko-KR/api/crash-reporter.md index eba31595981..4f9058aa217 100644 --- a/docs-translations/ko-KR/api/crash-reporter.md +++ b/docs-translations/ko-KR/api/crash-reporter.md @@ -39,7 +39,7 @@ crashReporter.start({ 다른 crashReporter API를 사용하기 전에 이 메서드를 먼저 호출해야 합니다. -**참고:** OS X에선 Windows와 Linux의 `breakpad`와 달리 새로운 `crashpad` +**참고:** macOS에선 Windows와 Linux의 `breakpad`와 달리 새로운 `crashpad` 클라이언트를 사용합니다. 오류 수집 기능을 활성화 시키려면 오류를 수집하고 싶은 메인 프로세스나 렌더러 프로세스에서 `crashReporter.start` 메서드를 호출하여 `crashpad`를 초기화해야 합니다. diff --git a/docs-translations/ko-KR/api/dialog.md b/docs-translations/ko-KR/api/dialog.md index 6b024d960af..c478d47bea1 100644 --- a/docs-translations/ko-KR/api/dialog.md +++ b/docs-translations/ko-KR/api/dialog.md @@ -105,7 +105,7 @@ const {dialog} = require('electron').remote; * `cancelId` Integer - 유저가 대화 상자의 버튼을 클릭하지 않고 대화 상자를 취소했을 때 반환되는 버튼의 인덱스입니다. 기본적으로 버튼 리스트가 "cancel" 또는 "no" 라벨을 가지고 있을 때 해당 버튼의 인덱스를 반환합니다. 따로 두 라벨이 지정되지 - 않은 경우 0을 반환합니다. OS X와 Windows에선 `cancelId` 지정 여부에 상관없이 + 않은 경우 0을 반환합니다. macOS와 Windows에선 `cancelId` 지정 여부에 상관없이 "Cancel" 버튼이 언제나 `cancelId`로 지정됩니다. * `noLink` Boolean - Windows에서 Electron은 ("Cancel"이나 "Yes"와 같은) 흔히 사용되는 버튼을 찾으려고 시도하고 대화 상자 내에서 해당 버튼을 커맨드 링크처럼 @@ -117,7 +117,7 @@ const {dialog} = require('electron').remote; 지정한 창을 사용할 수 없습니다. 완료 시 유저가 선택한 버튼의 인덱스를 반환합니다. **역자주:** 부정을 표현하는 "아니오", "취소"와 같은 한글 단어는 지원되지 않습니다. 만약 -OS X 또는 Windows에서 "확인", "취소"와 같은 순서로 버튼을 지정하게 될 때 Alt + f4로 +macOS 또는 Windows에서 "확인", "취소"와 같은 순서로 버튼을 지정하게 될 때 Alt + f4로 해당 대화 상자를 끄게 되면 "확인"을 누른 것으로 판단되어 버립니다. 이를 해결하려면 "Cancel"을 대신 사용하거나 BrowserWindow API를 사용하여 대화 상자를 직접 구현해야 합니다. @@ -136,7 +136,7 @@ Linux에서 `ready` 이벤트가 발생하기 전에 이 API를 호출할 경우 ## Sheets -Mac OS X에선, `browserWindow` 인수에 `BrowserWindow` 객체 참조를 전달하면 대화 +macOS에선, `browserWindow` 인수에 `BrowserWindow` 객체 참조를 전달하면 대화 상자가 해당 윈도우에 시트처럼 표시되도록 표현할 수 있습니다. 윈도우의 객체 참조가 제공되지 않으면 모달 형태로 표시됩니다. diff --git a/docs-translations/ko-KR/api/frameless-window.md b/docs-translations/ko-KR/api/frameless-window.md index 87255e7977e..3ca6e939545 100644 --- a/docs-translations/ko-KR/api/frameless-window.md +++ b/docs-translations/ko-KR/api/frameless-window.md @@ -17,9 +17,9 @@ const {BrowserWindow} = require('electron') let win = new BrowserWindow({width: 800, height: 600, frame: false}) ``` -### 최신 OS X에서 사용할 수 있는 대안 +### 최신 macOS에서 사용할 수 있는 대안 -OS X 10.10 Yosemite 이후의 최신 버전부터는 테두리가 없는 창을 만들 때 새로운 방법을 +macOS 10.10 Yosemite 이후의 최신 버전부터는 테두리가 없는 창을 만들 때 새로운 방법을 사용할 수 있습니다. `frame` 옵션을 `false`로 지정하여 제목과 창 구성 요소를 모두 비활성화하는 대신 새로운 `titleBarStyle` 옵션을 통해 제목만 숨기고 창 구성 요소 ("신호등 버튼")의 기능과 창 크기를 그대로 유지할 수 있습니다: @@ -52,7 +52,7 @@ let win = new BrowserWindow({transparent: true, frame: false}) upstream 버그가 있는 관계로 투명한 창 기능을 사용하려면 CLI 옵션에 `--enable-transparent-visuals --disable-gpu`을 추가해야 합니다. 이 옵션은 GPU의 사용을 중단하고 윈도우를 생성하는데 ARGB를 사용할 수 있도록 해줍니다. -* OS X(Mac)에선 네이티브 창에서 보여지는 그림자가 투명한 창에선 보이지 않습니다. +* macOS(Mac)에선 네이티브 창에서 보여지는 그림자가 투명한 창에선 보이지 않습니다. ## 클릭이 통과될 수 있는 윈도우 diff --git a/docs-translations/ko-KR/api/menu-item.md b/docs-translations/ko-KR/api/menu-item.md index bdd378334cd..cece1162f92 100644 --- a/docs-translations/ko-KR/api/menu-item.md +++ b/docs-translations/ko-KR/api/menu-item.md @@ -52,7 +52,7 @@ * `minimize` - 현재 윈도우를 최소화합니다 * `close` - 현재 윈도우를 닫습니다 -OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다: +macOS에서의 `role`은 다음 값을 추가로 가질 수 있습니다: * `about` - `orderFrontStandardAboutPanel` 액션에 대응 * `hide` - `hide` 액션에 대응 @@ -63,7 +63,7 @@ OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다: * `help` - 부 메뉴를 가지는 "Help" 메뉴 * `services` - 부 메뉴를 가지는 "Services" 메뉴 -OS X에서는 `role`을 지정할 때, `label`과 `accelerator`만 MenuItem에 효과가 +macOS에서는 `role`을 지정할 때, `label`과 `accelerator`만 MenuItem에 효과가 적용되도록 변경되며, 다른 옵션들은 모두 무시됩니다. ## Instance Properties diff --git a/docs-translations/ko-KR/api/menu.md b/docs-translations/ko-KR/api/menu.md index 8d696aa45c3..4cf160d1b4a 100644 --- a/docs-translations/ko-KR/api/menu.md +++ b/docs-translations/ko-KR/api/menu.md @@ -202,20 +202,20 @@ Menu.setApplicationMenu(menu); * `menu` Menu -지정한 `menu`를 애플리케이션 메뉴로 만듭니다. OS X에선 상단바에 표시되며 Windows와 +지정한 `menu`를 애플리케이션 메뉴로 만듭니다. macOS에선 상단바에 표시되며 Windows와 Linux에선 각 창의 상단에 표시됩니다. **참고** 이 API는 `app`의 `ready` 이벤트가 발생한 이후에 호출해야 합니다. -### `Menu.sendActionToFirstResponder(action)` _OS X_ +### `Menu.sendActionToFirstResponder(action)` _macOS_ * `action` String `action`을 애플리케이션의 first responder에 전달합니다. 이 메서드는 Cocoa 메뉴 동작을 에뮬레이트 하는데 사용되며 보통 `MenuItem`의 `role` 속성에 사용됩니다. -OS X의 네이티브 액션에 대해 자세히 알아보려면 -[OS X Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7) +macOS의 네이티브 액션에 대해 자세히 알아보려면 +[macOS Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7) 문서를 참고하세요. ### `Menu.buildFromTemplate(template)` @@ -237,13 +237,13 @@ OS X의 네이티브 액션에 대해 자세히 알아보려면 * `browserWindow` BrowserWindow (optional) - 기본값은 `null`입니다. * `x` Number (optional) - 기본값은 -1입니다. * `y` Number (만약 `x`를 지정한 경우 **필수 항목**) - 기본값은 -1입니다. -* `positioningItem` Number (optional) _OS X_ - 메뉴 팝업 시 마우스 커서에 바로 +* `positioningItem` Number (optional) _macOS_ - 메뉴 팝업 시 마우스 커서에 바로 위치시킬 메뉴 아이템의 인덱스. 기본값은 -1입니다. 메뉴를 `browserWindow` 내부 팝업으로 표시합니다. 옵션으로 메뉴를 표시할 `(x,y)` 좌표를 지정할 수 있습니다. 따로 좌표를 지정하지 않은 경우 마우스 커서 위치에 표시됩니다. `positioningItem` 속성은 메뉴 팝업 시 마우스 커서에 바로 위치시킬 메뉴 아이템의 -인덱스입니다. (OS X에서만 지원합니다) +인덱스입니다. (macOS에서만 지원합니다) ### `menu.append(menuItem)` @@ -266,15 +266,15 @@ OS X의 네이티브 액션에 대해 자세히 알아보려면 메뉴가 가지고 있는 메뉴 아이템들의 배열입니다. -## OS X 애플리케이션 메뉴에 대해 알아 둬야 할 것들 +## macOS 애플리케이션 메뉴에 대해 알아 둬야 할 것들 -OS X에선 Windows, Linux와 달리 완전히 다른 애플리케이션 메뉴 스타일을 가지고 있습니다. +macOS에선 Windows, Linux와 달리 완전히 다른 애플리케이션 메뉴 스타일을 가지고 있습니다. 그래서 애플리케이션을 네이티브처럼 작동할 수 있도록 하기 위해 다음 몇 가지 유의 사항을 숙지해야 합니다. ### 기본 메뉴 -OS X엔 `Services`나 `Windows`와 같은 많은 시스템 지정 기본 메뉴가 있습니다. 기본 +macOS엔 `Services`나 `Windows`와 같은 많은 시스템 지정 기본 메뉴가 있습니다. 기본 메뉴를 만들려면 반드시 다음 리스트 중 한 가지를 선택하여 메뉴의 `role`로 지정해야 합니다. 그러면 Electron이 자동으로 인식하여 해당 메뉴를 기본 메뉴로 만듭니다: @@ -284,13 +284,13 @@ OS X엔 `Services`나 `Windows`와 같은 많은 시스템 지정 기본 메뉴 ### 메뉴 아이템 기본 동작 -OS X는 몇가지 메뉴 아이템에 대해 `About xxx`, `Hide xxx`, `Hide Others`와 같은 +macOS는 몇가지 메뉴 아이템에 대해 `About xxx`, `Hide xxx`, `Hide Others`와 같은 기본 동작을 제공하고 있습니다. 메뉴 아이템의 기본 동작을 지정하려면 반드시 메뉴 아이템의 `role` 속성을 지정해야 합니다. ### 메인 메뉴의 이름 -OS X에선 지정한 애플리케이션 메뉴에 상관없이 메뉴의 첫번째 라벨은 언제나 애플리케이션의 +macOS에선 지정한 애플리케이션 메뉴에 상관없이 메뉴의 첫번째 라벨은 언제나 애플리케이션의 이름이 됩니다. 애플리케이션 이름을 변경하려면 앱 번들내의 `Info.plist` 파일을 수정해야 합니다. 자세한 내용은 [About Information Property List Files][AboutInformationPropertyListFiles] 문서를 참고하세요. diff --git a/docs-translations/ko-KR/api/native-image.md b/docs-translations/ko-KR/api/native-image.md index c84a89941b4..d44f000a1c9 100644 --- a/docs-translations/ko-KR/api/native-image.md +++ b/docs-translations/ko-KR/api/native-image.md @@ -79,7 +79,7 @@ let appIcon = new Tray('/Users/somebody/images/icon.png'); 가장 일반적으로 템플릿 이미지는 밝고 어두운 테마 색상으로 변경할 수 있는 메뉴 바 아이콘 등에 사용되고 있습니다. -**참고:** 템플릿 이미지는 OS X 운영체제만 지원합니다. +**참고:** 템플릿 이미지는 macOS 운영체제만 지원합니다. 템플릿 이미지를 지정하려면 다음 예시와 같이 파일명에 `Template` 문자열을 추가해야 합니다: @@ -139,10 +139,10 @@ let image = nativeImage.createFromPath('/Users/somebody/images/icon.png'); 이미지를 data URL로 반환합니다. -### `image.getNativeHandle()` _OS X_ +### `image.getNativeHandle()` _macOS_ 이미지의 네이티브 핸들 밑에 있는 C 포인터를 담은 [Buffer][buffer]을 반환합니다. -OS X에선, `NSImage` 인스턴스가 반환됩니다. +macOS에선, `NSImage` 인스턴스가 반환됩니다. 참고로 반환된 포인터는 복사본이 아닌 네이티브 이미지의 밑에 있는 약한 포인터이며, 따라서 반드시 관련된 `nativeImage` 인스턴스가 확실하게 유지되고 있는지를 인지해야 diff --git a/docs-translations/ko-KR/api/process.md b/docs-translations/ko-KR/api/process.md index 946dd92eac5..d7f27bc33dd 100644 --- a/docs-translations/ko-KR/api/process.md +++ b/docs-translations/ko-KR/api/process.md @@ -74,7 +74,7 @@ Causes the main thread of the current process crash. Causes the main thread of the current process hang. -### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_ +### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_ * `maxDescriptors` Integer @@ -133,7 +133,7 @@ On Windows / Linux: 현재 프로세스의 주 스레드를 중단시킵니다. -### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_ +### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs-translations/ko-KR/api/shell.md b/docs-translations/ko-KR/api/shell.md index 9cf8b1e564c..2079fa0829e 100644 --- a/docs-translations/ko-KR/api/shell.md +++ b/docs-translations/ko-KR/api/shell.md @@ -31,7 +31,7 @@ shell.openExternal('https://github.com'); ### `shell.openExternal(url[, options])` * `url` String -* `options` Object (optional) _OS X_ +* `options` Object (optional) _macOS_ * `activate` Boolean - `true`로 설정하면 애플리케이션을 바로 활성화 상태로 실행합니다. 기본값은 `true`입니다. diff --git a/docs-translations/ko-KR/api/system-preferences.md b/docs-translations/ko-KR/api/system-preferences.md index 9b53baee35b..254bd006874 100644 --- a/docs-translations/ko-KR/api/system-preferences.md +++ b/docs-translations/ko-KR/api/system-preferences.md @@ -4,17 +4,17 @@ ## Methods -### `systemPreferences.isDarkMode()` _OS X_ +### `systemPreferences.isDarkMode()` _macOS_ 이 메서드는 시스템이 어두운 모드 상태인 경우 `true`를 반환하고 아닐 경우 `false`를 반환합니다. -### `systemPreferences.subscribeNotification(event, callback)` _OS X_ +### `systemPreferences.subscribeNotification(event, callback)` _macOS_ * `event` String * `callback` Function -OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하면 `callback`이 +macOS의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하면 `callback`이 `callback(event, userInfo)` 형태로 호출됩니다. `userInfo`는 알림과 함께 전송되는 사용자 정보 딕셔너리를 포함하는 객체입니다. @@ -28,13 +28,13 @@ OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하 * `AppleColorPreferencesChangedNotification` * `AppleShowScrollBarsSettingChanged` -### `systemPreferences.unsubscribeNotification(id)` _OS X_ +### `systemPreferences.unsubscribeNotification(id)` _macOS_ * `id` Integer `id`와 함께 구독자를 제거합니다. -### `systemPreferences.getUserDefault(key, type)` _OS X_ +### `systemPreferences.getUserDefault(key, type)` _macOS_ * `key` String * `type` String - `string`, `boolean`, `integer`, `float`, `double`, `url`, @@ -42,7 +42,7 @@ OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하 시스템 설정에서 `key`에 해당하는 값을 가져옵니다. -OS X에선 API가 `NSUserDefaults`를 읽어들입니다. 유명한 `key`와 `type`은 다음과 +macOS에선 API가 `NSUserDefaults`를 읽어들입니다. 유명한 `key`와 `type`은 다음과 같습니다: * `AppleInterfaceStyle: string` diff --git a/docs-translations/ko-KR/api/tray.md b/docs-translations/ko-KR/api/tray.md index b9420acfeb1..a2a01855368 100644 --- a/docs-translations/ko-KR/api/tray.md +++ b/docs-translations/ko-KR/api/tray.md @@ -71,9 +71,9 @@ appIcon.setContextMenu(contextMenu); 트레이 아이콘이 클릭될 때 발생하는 이벤트입니다. -**참고:** `bounds`는 OS X 와 Windows에서만 작동합니다. +**참고:** `bounds`는 macOS 와 Windows에서만 작동합니다. -### Event: 'right-click' _OS X_ _Windows_ +### Event: 'right-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -88,7 +88,7 @@ appIcon.setContextMenu(contextMenu); 트레이 아이콘을 오른쪽 클릭될 때 호출 됩니다. -### Event: 'double-click' _OS X_ _Windows_ +### Event: 'double-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -115,26 +115,26 @@ appIcon.setContextMenu(contextMenu); 풍선 팝업이 시간이 지나 사라지거나 유저가 클릭하여 닫을 때 발생하는 이벤트입니다. -### Event: 'drop' _OS X_ +### Event: 'drop' _macOS_ 드래그 가능한 아이템이 트레이 아이콘에 드롭되면 발생하는 이벤트입니다. -### Event: 'drop-files' _OS X_ +### Event: 'drop-files' _macOS_ * `event` * `files` Array - 드롭된 파일의 경로 트레이 아이콘에 파일이 드롭되면 발생하는 이벤트입니다. -### Event: 'drag-enter' _OS X_ +### Event: 'drag-enter' _macOS_ 트레이 아이콘에 드래그 작업이 시작될 때 발생하는 이벤트입니다. -### Event: 'drag-leave' _OS X_ +### Event: 'drag-leave' _macOS_ 트레이 아이콘에 드래그 작업이 종료될 때 발생하는 이벤트입니다. -### Event: 'drag-end' _OS X_ +### Event: 'drag-end' _macOS_ 트레이 아이콘에 드래그 작업이 종료되거나 다른 위치에서 종료될 때 발생하는 이벤트입니다. @@ -154,7 +154,7 @@ appIcon.setContextMenu(contextMenu); `image`를 사용하여 트레이 아이콘의 이미지를 설정합니다. -### `Tray.setPressedImage(image)` _OS X_ +### `Tray.setPressedImage(image)` _macOS_ * `image` [NativeImage](native-image.md) @@ -166,13 +166,13 @@ appIcon.setContextMenu(contextMenu); 트레이 아이콘의 툴팁 텍스트를 설정합니다. -### `Tray.setTitle(title)` _OS X_ +### `Tray.setTitle(title)` _macOS_ * `title` String 상태바에서 트레이 아이콘 옆에 표시되는 제목 텍스트를 설정합니다. -### `Tray.setHighlightMode(highlight)` _OS X_ +### `Tray.setHighlightMode(highlight)` _macOS_ * `highlight` Boolean @@ -188,7 +188,7 @@ appIcon.setContextMenu(contextMenu); 트레이에 풍선 팝업을 생성합니다. -### `Tray.popUpContextMenu([menu, position])` _OS X_ _Windows_ +### `Tray.popUpContextMenu([menu, position])` _macOS_ _Windows_ * `menu` Menu (optional) * `position` Object (optional) - 팝업 메뉴의 위치 diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index 3066012a299..437b5dabbe7 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -944,7 +944,7 @@ win.webContents.on('did-finish-load', () => { }); ``` -### `webContents.showDefinitionForSelection()` _OS X_ +### `webContents.showDefinitionForSelection()` _macOS_ 페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다. diff --git a/docs-translations/ko-KR/api/web-view-tag.md b/docs-translations/ko-KR/api/web-view-tag.md index 99f579e075f..7238ea69abf 100644 --- a/docs-translations/ko-KR/api/web-view-tag.md +++ b/docs-translations/ko-KR/api/web-view-tag.md @@ -478,7 +478,7 @@ Service worker에 대한 개발자 도구를 엽니다. `event` 객체에 대해 자세히 알아보려면 [webContents.sendInputEvent](web-contents.md##webcontentssendinputeventevent)를 참고하세요. -### `.showDefinitionForSelection()` _OS X_ +### `.showDefinitionForSelection()` _macOS_ 페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다. diff --git a/docs-translations/ko-KR/development/build-instructions-osx.md b/docs-translations/ko-KR/development/build-instructions-osx.md index 55a88b0cefd..9527a712fe1 100644 --- a/docs-translations/ko-KR/development/build-instructions-osx.md +++ b/docs-translations/ko-KR/development/build-instructions-osx.md @@ -1,10 +1,10 @@ -# 빌드 설명서 (OS X) +# 빌드 설명서 (macOS) -이 가이드는 OS X 운영체제에서 Electron을 빌드하는 방법을 설명합니다. +이 가이드는 macOS 운영체제에서 Electron을 빌드하는 방법을 설명합니다. ## 빌드전 요구 사항 -* OS X >= 10.8 +* macOS >= 10.8 * [Xcode](https://developer.apple.com/technologies/tools/) >= 5.1 * [node.js](http://nodejs.org) (external) @@ -47,7 +47,7 @@ $ ./script/build.py -c D ## 32비트 지원 -Electron은 현재 OS X 64비트만 지원하고 있습니다. 그리고 앞으로도 OS X 32비트는 지원할 +Electron은 현재 macOS 64비트만 지원하고 있습니다. 그리고 앞으로도 macOS 32비트는 지원할 계획이 없습니다. ## 테스트 diff --git a/docs-translations/ko-KR/styleguide.md b/docs-translations/ko-KR/styleguide.md index 340fa4204a0..6fd30bbef10 100644 --- a/docs-translations/ko-KR/styleguide.md +++ b/docs-translations/ko-KR/styleguide.md @@ -27,7 +27,7 @@ Electron 문서를 작성하는 규칙은 다음과 같습니다. - 선택적 인수는 목록에서 호출되면 표시합니다. - 문장의 길이는 한 줄당 80 칸을 유지합니다. - 플랫폼 특정 메서드 헤더는 이탈릭체로 표시합니다. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` - 'on' 표현 대신 'in the ___ process' 형식의 표현을 지향합니다. ### 번역된 참조 문서 diff --git a/docs-translations/ko-KR/tutorial/application-distribution.md b/docs-translations/ko-KR/tutorial/application-distribution.md index 34d129b3e9c..1b4dde82df8 100644 --- a/docs-translations/ko-KR/tutorial/application-distribution.md +++ b/docs-translations/ko-KR/tutorial/application-distribution.md @@ -3,10 +3,10 @@ Electron 애플리케이션을 배포하는 방법은 간단합니다. 먼저 폴더 이름을 `app`로 지정한 후 Electron 리소스 디렉터리에 폴더를 통째로 집어넣기만 -하면 됩니다. 리소스 디렉터리는 OS X의 경우: `Electron.app/Contents/Resources/` +하면 됩니다. 리소스 디렉터리는 macOS의 경우: `Electron.app/Contents/Resources/` Windows와 Linux의 경우: `resources/` 입니다. -OS X의 경우: +macOS의 경우: ```text electron/Electron.app/Contents/Resources/app/ @@ -37,7 +37,7 @@ electron/resources/app `app.asar` 파일로 대체하면됩니다. Electron은 자동으로 `app`폴더 대신 asar 아카이브를 기반으로 애플리케이션을 실행합니다. -OS X의 경우: +macOS의 경우: ```text electron/Electron.app/Contents/Resources/ @@ -62,7 +62,7 @@ electron/resources/ [rcedit](https://github.com/atom/rcedit)를 통해 `electron.exe`을 원하는 이름으로 변경할 수 있고, 또한 아이콘과 기타 정보도 변경할 수 있습니다. -### OS X +### macOS `Electron.app`을 원하는 이름으로 변경할 수 있습니다. 그리고 다음 표시된 애플리케이션 내부 파일에서 `CFBundleDisplayName`, `CFBundleIdentifier` 그리고 `CFBundleName` diff --git a/docs-translations/ko-KR/tutorial/desktop-environment-integration.md b/docs-translations/ko-KR/tutorial/desktop-environment-integration.md index 54cfb70e48e..b3c4d91d5cb 100644 --- a/docs-translations/ko-KR/tutorial/desktop-environment-integration.md +++ b/docs-translations/ko-KR/tutorial/desktop-environment-integration.md @@ -2,14 +2,14 @@ 애플리케이션 배포의 대상이 되는 서로 다른 운영체제 시스템의 환경에 맞춰 애플리케이션의 기능을 통합할 수 있습니다. 예를 들어 Windows에선 태스크바의 JumpList에 바로가기를 -추가할 수 있고 Mac(OS X)에선 dock 메뉴에 커스텀 메뉴를 추가할 수 있습니다. +추가할 수 있고 Mac(macOS)에선 dock 메뉴에 커스텀 메뉴를 추가할 수 있습니다. 이 문서는 Electron API를 이용하여 각 운영체제 시스템의 기능을 활용하는 방법을 설명합니다. -## 데스크톱 알림 (Windows, Linux, OS X) +## 데스크톱 알림 (Windows, Linux, macOS) -Windows, Linux, OS X 운영체제 모두 기본적으로 애플리케이션에서 유저에게 알림을 보내는 +Windows, Linux, macOS 운영체제 모두 기본적으로 애플리케이션에서 유저에게 알림을 보내는 방법을 제공합니다. Electron은 [HTML5 Notification API](https://notifications.spec.whatwg.org/)를 통해 개발자가 편리하게 데스크톱 알림을 사용할 수 있는 기능을 제공합니다. 데스크톱 알림은 운영체제의 네이티브 알림 API를 사용하여 표시합니다. @@ -47,18 +47,18 @@ myNotification.onclick = () => { 따르는 모든 데스크탑 환경에서 데스크톱 알림 기능을 사용할 수 있습니다. Cinnamon, Enlightenment, Unity, GNOME, KDE등을 지원합니다. -### OS X +### macOS -OS X에서의 데스크톱 알림은 아주 직관적입니다. 하지만 데스크톱 알림을 사용할 땐 +macOS에서의 데스크톱 알림은 아주 직관적입니다. 하지만 데스크톱 알림을 사용할 땐 [Apple's Human Interface guidelines regarding notifications](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html) 가이드를 고려해야 합니다. 참고로 데스크롭 알림의 최대 길이는 256 바이트 입니다. 길이가 초과할 경우 초과한 글자가 잘립니다. -## 최근 사용한 문서 (Windows & OS X) +## 최근 사용한 문서 (Windows & macOS) -Windows와 OS X는 JumpList 또는 dock 메뉴를 통해 최근 문서 리스트에 쉽게 접근할 수 +Windows와 macOS는 JumpList 또는 dock 메뉴를 통해 최근 문서 리스트에 쉽게 접근할 수 있습니다. __JumpList:__ @@ -93,13 +93,13 @@ app.clearRecentDocuments(); 유저가 JumpList에서 파일을 클릭할 경우 클릭된 파일의 경로가 커맨드 라인 인수로 추가되어 새로운 인스턴스의 애플리케이션이 실행됩니다. -### OS X에서 주의할 점 +### macOS에서 주의할 점 파일이 최근 문서 메뉴에서 요청될 경우 `app` 모듈의 `open-file` 이벤트가 호출됩니다. -## 커스텀 독 메뉴 (OS X) +## 커스텀 독 메뉴 (macOS) -OS X는 개발자가 dock에 커스텀 메뉴를 만들 수 있도록 허용하고 있습니다. +macOS는 개발자가 dock에 커스텀 메뉴를 만들 수 있도록 허용하고 있습니다. 보통 애플리케이션의 특정 기능 바로가기를 만들 때 사용합니다: __Terminal.app의 dock menu:__ @@ -107,7 +107,7 @@ __Terminal.app의 dock menu:__ 커스텀 dock menu를 설정하려면 `app.dock.setMenu` API를 사용하면 됩니다. -OS X에서만 사용 가능합니다: +macOS에서만 사용 가능합니다: ```javascript const {app, Menu} = require('electron'); @@ -147,7 +147,7 @@ __Internet Explorer의 작업:__ ![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png) -OS X의 dock menu(진짜 메뉴)와는 달리 Windows의 사용자 작업은 애플리케이션 바로 +macOS의 dock menu(진짜 메뉴)와는 달리 Windows의 사용자 작업은 애플리케이션 바로 가기처럼 작동합니다. 유저가 작업을 클릭할 때 설정한 인수와 함께 새로운 애플리케이션이 실행됩니다. @@ -241,13 +241,13 @@ __Audacious의 런처 숏컷:__ ![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png) -## 작업 표시줄 안의 프로그래스 바 (Windows, OS X, Unity) +## 작업 표시줄 안의 프로그래스 바 (Windows, macOS, Unity) Windows에선 작업 표시줄의 애플리케이션 버튼에 프로그래스 바를 추가할 수 있습니다. 이 기능은 사용자가 애플리케이션의 창을 열지 않고도 애플리케이션의 작업의 상태 정보를 시각적으로 보여줄 수 있도록 해줍니다. -OS X에선 프로그래스바가 dock 아이콘의 일부에 표시됩니다. +macOS에선 프로그래스바가 dock 아이콘의 일부에 표시됩니다. 또한 Unity DE도 런처에 프로그래스 바를 부착할 수 있습니다. @@ -290,9 +290,9 @@ let win = new BrowserWindow({...}); win.setOverlayIcon('path/to/overlay.png', 'Description for overlay'); ``` -## 대표 파일 제시 (OS X) +## 대표 파일 제시 (macOS) -OS X는 창에서 대표 파일을 설정할 수 있습니다. 타이틀바에서 파일 아이콘이 있고, 사용자가 +macOS는 창에서 대표 파일을 설정할 수 있습니다. 타이틀바에서 파일 아이콘이 있고, 사용자가 Command-Click 또는 Control-Click 키를 누를 경우 파일 경로 팝업이 보여집니다. 또한 창의 상태도 지정할 수 있습니다. 다시 말해 로드된 문서의 수정 여부를 제목의 파일 아이콘에 표시할 수 있습니다. diff --git a/docs-translations/ko-KR/tutorial/devtools-extension.md b/docs-translations/ko-KR/tutorial/devtools-extension.md index 484a159351b..2640b02a6cb 100644 --- a/docs-translations/ko-KR/tutorial/devtools-extension.md +++ b/docs-translations/ko-KR/tutorial/devtools-extension.md @@ -23,7 +23,7 @@ Electron에 확장 기능을 로드하려면, Chrome 브라우저에서 다운 * `~/.config/google-chrome-beta/Default/Extensions/` * `~/.config/google-chrome-canary/Default/Extensions/` * `~/.config/chromium/Default/Extensions/` - * OS X에선 `~/Library/Application Support/Google/Chrome/Default/Extensions`. + * macOS에선 `~/Library/Application Support/Google/Chrome/Default/Extensions`. 4. 확장 기능의 경로를 `BrowserWindow.addDevToolsExtension` API로 전달합니다. React Developer Tools의 경우 다음과 비슷해야 합니다: `~/Library/Application Support/Google/Chrome/Default/Extensions/fmkadmapgofadopljbjfkapdkoienihi/0.14.10_0` diff --git a/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md b/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md index 00d9b9d9e5c..62bff3a9978 100644 --- a/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md +++ b/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md @@ -116,7 +116,7 @@ codesign -s "$APP_KEY" -f --entitlements "$PARENT_PLIST" "$APP_PATH" productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH" ``` -만약 OS X의 샌드박스 개념에 대해 처음 접한다면 Apple의 [Enabling App Sandbox][enable-app-sandbox] +만약 macOS의 샌드박스 개념에 대해 처음 접한다면 Apple의 [Enabling App Sandbox][enable-app-sandbox] 문서를 참고하여 기본적인 개념을 이해해야 합니다. 그리고 자격(plist) 파일에 애플리케이션에서 요구하는 권한의 키를 추가합니다. diff --git a/docs-translations/ko-KR/tutorial/quick-start.md b/docs-translations/ko-KR/tutorial/quick-start.md index df3fc09fa29..37611d319fc 100644 --- a/docs-translations/ko-KR/tutorial/quick-start.md +++ b/docs-translations/ko-KR/tutorial/quick-start.md @@ -112,7 +112,7 @@ app.on('ready', createWindow); // 모든 창이 닫히면 애플리케이션 종료. app.on('window-all-closed', () => { - // OS X의 대부분의 애플리케이션은 유저가 Cmd + Q 커맨드로 확실하게 + // macOS의 대부분의 애플리케이션은 유저가 Cmd + Q 커맨드로 확실하게 // 종료하기 전까지 메뉴바에 남아 계속 실행됩니다. if (process.platform !== 'darwin') { app.quit(); @@ -120,7 +120,7 @@ app.on('window-all-closed', () => { }); app.on('activate', () => { - // OS X에선 보통 독 아이콘이 클릭되고 나서도 + // macOS에선 보통 독 아이콘이 클릭되고 나서도 // 열린 윈도우가 없으면, 새로운 윈도우를 다시 만듭니다. if (win === null) { createWindow(); @@ -196,7 +196,7 @@ $ .\electron\electron.exe your-app\ $ ./electron/electron your-app/ ``` -#### OS X +#### macOS ```bash $ ./Electron.app/Contents/MacOS/Electron your-app/ diff --git a/docs-translations/ko-KR/tutorial/supported-platforms.md b/docs-translations/ko-KR/tutorial/supported-platforms.md index d71951cd3d8..d2d71c1454e 100644 --- a/docs-translations/ko-KR/tutorial/supported-platforms.md +++ b/docs-translations/ko-KR/tutorial/supported-platforms.md @@ -2,9 +2,9 @@ Electron에선 다음과 같은 플랫폼을 지원합니다: -### OS X +### macOS -OS X는 64비트 바이너리만 제공됩니다. 그리고 최소 OS X 지원 버전은 10.9입니다. +macOS는 64비트 바이너리만 제공됩니다. 그리고 최소 macOS 지원 버전은 10.9입니다. ### Windows diff --git a/docs-translations/ko-KR/tutorial/testing-on-headless-ci.md b/docs-translations/ko-KR/tutorial/testing-on-headless-ci.md index 5718209654d..748c8054d86 100644 --- a/docs-translations/ko-KR/tutorial/testing-on-headless-ci.md +++ b/docs-translations/ko-KR/tutorial/testing-on-headless-ci.md @@ -18,11 +18,11 @@ Electron의 Chromium은 자동적으로 `$DISPLAY` 변수를 찾습니다. 따 다른 설정이 필요하지 않습니다. 이러한 작업은 Paul Betts의 [xvfb-maybe](https://github.com/paulcbetts/xvfb-maybe)를 통해 자동화 할 수 있습니다: `xvfb-maybe`를 테스트 커맨드 앞에 추가하고 현재 시스템에서 요구하면 -이 작은 툴이 자동적으로 xvfb를 설정합니다. Windows와 Mac OS X에선 간단히 아무 작업도 +이 작은 툴이 자동적으로 xvfb를 설정합니다. Windows와 macOS에선 간단히 아무 작업도 하지 않습니다. ``` -## Windows와 OS X에선, 그저 electron-mocha를 호출합니다 +## Windows와 macOS에선, 그저 electron-mocha를 호출합니다 ## Linux에선, 현재 headless 환경에 있는 경우 ## xvfb-run electron-mocha ./test/*.js와 같습니다 xvfb-maybe electron-mocha ./test/*.js diff --git a/docs-translations/ko-KR/tutorial/using-pepper-flash-plugin.md b/docs-translations/ko-KR/tutorial/using-pepper-flash-plugin.md index e813491435b..0a4878153aa 100644 --- a/docs-translations/ko-KR/tutorial/using-pepper-flash-plugin.md +++ b/docs-translations/ko-KR/tutorial/using-pepper-flash-plugin.md @@ -19,7 +19,7 @@ Electron은 Pepper 플래시 플러그인을 지원합니다. Electron에서 Pep ```javascript // 플래시 플러그인의 위치를 설정합니다. // Windows의 경우, /path/to/pepflashplayer.dll 또는 main.js에 존재하는 경우 pepflashplayer.dll -// OS X의 경우, /path/to/PepperFlashPlayer.plugin +// macOS의 경우, /path/to/PepperFlashPlayer.plugin // Linux의 경우, /path/to/libpepflashplayer.so app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so'); diff --git a/docs-translations/ko-KR/tutorial/using-widevine-cdm-plugin.md b/docs-translations/ko-KR/tutorial/using-widevine-cdm-plugin.md index 6b7496bd326..3be7f70a8c2 100644 --- a/docs-translations/ko-KR/tutorial/using-widevine-cdm-plugin.md +++ b/docs-translations/ko-KR/tutorial/using-widevine-cdm-plugin.md @@ -12,7 +12,7 @@ Chrome 브라우저를 설치해야 합니다. 같습니다, 만약 그렇지 않다면 `navigator.plugins`가 로드됐더라도 정상적으로 작동하지 않습니다. -### Windows & OS X +### Windows & macOS Chrome 브라우저에서 `chrome://components/`를 열고 `WidevineCdm`을 찾은 후 확실히 최신버전인지 확인합니다. 여기까지 하면 모든 플러그인 바이너리를 @@ -20,13 +20,13 @@ Chrome 브라우저에서 `chrome://components/`를 열고 `WidevineCdm`을 찾 디렉터리에서 찾을 수 있습니다. `APP_DATA`는 애플리케이션 데이터를 저장하고 있는 시스템 경로입니다. Windows에선 -`%LOCALAPPDATA%`로 접근할 수 있고 OS X에선 `~/Library/Application Support`로 +`%LOCALAPPDATA%`로 접근할 수 있고 macOS에선 `~/Library/Application Support`로 접근할 수 있습니다. `VERSION`은 `1.4.8.866` 같은 Widevine CDM 플러그인의 버전 문자열입니다. `PLATFORM`은 플랫폼을 뜻하며 `mac` 또는 `win`이 될 수 있으며 `ARCH`는 아키텍쳐를 뜻하고 `x86` 또는 `x64`가 될 수 있습니다. Windows에선 `widevinecdm.dll` 와 `widevinecdmadapter.dll` 같은 바이너리를 -요구하며 OS X에선 `libwidevinecdm.dylib`와 `widevinecdmadapter.plugin` 바이너리를 +요구하며 macOS에선 `libwidevinecdm.dylib`와 `widevinecdmadapter.plugin` 바이너리를 요구합니다. 원하는 곳에 이들을 복사해 놓을 수 있습니다. 하지만 반드시 바이너리는 같은 위치에 두어야 합니다. @@ -52,7 +52,7 @@ Linux에선 플러그인 바이너리들이 Chrome 브라우저와 함께 제공 ```javascript // `widevinecdmadapter`의 파일 이름을 이곳에 전달해야 합니다. 파일 이름은 -// * OS X에선 `widevinecdmadapter.plugin`로 지정합니다, +// * macOS에선 `widevinecdmadapter.plugin`로 지정합니다, // * Linux에선 `libwidevinecdmadapter.so`로 지정합니다, // * Windows에선 `widevinecdmadapter.dll`로 지정합니다. app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin'); diff --git a/docs-translations/pt-BR/api/accelerator.md b/docs-translations/pt-BR/api/accelerator.md index 92d70c844e8..7d4df4c79da 100644 --- a/docs-translations/pt-BR/api/accelerator.md +++ b/docs-translations/pt-BR/api/accelerator.md @@ -11,11 +11,11 @@ Exemplos: ## Aviso sobre plataformas No Linux e no Windows a tecla `Command` não tem nenhum efeito, -então use `CommandOrControl` que representa a tecla `Command` existente no OS X e +então use `CommandOrControl` que representa a tecla `Command` existente no macOS e `Control` no Linux e no Windows para definir aceleradores (atalhos). A chave `Super` está mapeada para a tecla `Windows` para Windows e Linux, -e para a tecla `Cmd` para OS X. +e para a tecla `Cmd` para macOS. ## Modificadores disponíveis diff --git a/docs-translations/pt-BR/api/app.md b/docs-translations/pt-BR/api/app.md index 85cfaade585..c18a803439a 100644 --- a/docs-translations/pt-BR/api/app.md +++ b/docs-translations/pt-BR/api/app.md @@ -18,7 +18,7 @@ O objeto `app` emite os seguintes eventos: ### Evento: 'will-finish-launching' Emitido quando o aplicativo finaliza a inicialização básica. No Windows e no Linux, -o evento `will-finish-launching` é o mesmo que o evento `ready`; No OS X, +o evento `will-finish-launching` é o mesmo que o evento `ready`; No macOS, esse evento representa a notificação `applicationWillFinishLaunching` do `NSApplication`. Normalmente aqui seriam criados *listeners* para os eventos `open-file` e `open-url`, e inicializar o *crash reporter* e atualizador automático. @@ -65,7 +65,7 @@ evento `will-quit` e `window-all-closed`. Emitido quando o aplicativo está finalizando. -### Evento: 'open-file' _OS X_ +### Evento: 'open-file' _macOS_ Retorna: @@ -85,7 +85,7 @@ Você deve chamar `event.preventDefault()` se quiser cuidar deste caso. No Windows, você deve fazer o *parse* do `process.argv` para pegar o endereço do arquivo. -### Evento: 'open-url' _OS X_ +### Evento: 'open-url' _macOS_ Retorna: @@ -97,7 +97,7 @@ ser registrado para ser aberto pelo seu aplicativo. Você deve chamar `event.preventDefault()` se quiser cuidar deste caso. -### Evento: 'activate' _OS X_ +### Evento: 'activate' _macOS_ Retorna: @@ -266,7 +266,7 @@ Você pode requisitar os seguintes endereços pelo nome: * `appData` Diretório de dados do aplicativo por usuário, que por padrão aponta para: * `%APPDATA%` no Windows * `$XDG_CONFIG_HOME` ou `~/.config` no Linux - * `~/Library/Application Support` no OS X + * `~/Library/Application Support` no macOS * `userData` O diretório para guardar os arquivos de configuração do seu aplicativo, que por padrão é o diretório `appData` concatenado com o nome do seu aplicativo. * `temp` Diretório temporário. * `exe` O arquivo executável atual. @@ -312,16 +312,16 @@ seu aplicativo, e que será preferido ao `name` pelo Electron. Retorna a localidade atual do aplicativo. -### `app.addRecentDocument(path)` _OS X_ _Windows_ +### `app.addRecentDocument(path)` _macOS_ _Windows_ * `path` String Adiciona `path` à lista de documentos recentes. Esta lista é gerenciada pelo S.O.. No Windows você pode visitar a lista pela -barra de tarefas, e no OS X você pode visita-la pelo *dock*. +barra de tarefas, e no macOS você pode visita-la pelo *dock*. -### `app.clearRecentDocuments()` _OS X_ _Windows_ +### `app.clearRecentDocuments()` _macOS_ _Windows_ Limpa a lista de documentos recentes. @@ -361,7 +361,7 @@ Normalmente aplicativos respondem à isso não minimizando sua janela primária Este método retorna `false` caso seu processo seja a instância primária do aplicativo e seu aplicativo deve continuar carregando. E retorna `true` caso seu processo tenha enviado seus parâmetros para outra instância, e você deve imediatamente finalizar. -No OS X o sistema enforça instância única automaticamente quando usuários tentam abrir uma segunda instância do seu aplicativo no *Finder*, e os eventos `open-file` e `open-url` serão emitidos para isso. Entretanto, quando usuários inicializam seu aplicativo na linha de comando, o mecanismo de instância única do sistema será ignorado e você terá de utilizar esse método para assegurar-se de ter uma instância única. +No macOS o sistema enforça instância única automaticamente quando usuários tentam abrir uma segunda instância do seu aplicativo no *Finder*, e os eventos `open-file` e `open-url` serão emitidos para isso. Entretanto, quando usuários inicializam seu aplicativo na linha de comando, o mecanismo de instância única do sistema será ignorado e você terá de utilizar esse método para assegurar-se de ter uma instância única. Um exemplo de ativação da janela de primeira instância quando uma segunda instância inicializa: @@ -405,7 +405,7 @@ Adiciona um argumento à linha de comando do Chromium. O argumento será passado **Nota:** Isto não irá afetar `process.argv`. -### `app.dock.bounce([type])` _OS X_ +### `app.dock.bounce([type])` _macOS_ * `type` String (opcional) - Pode ser `critical` ou `informational`. O padrão é `informational` @@ -417,31 +417,31 @@ Entretanto, a requisição se mantém ativa até que o aplicativo se torne ativo Retorna um ID representando a requisição. -### `app.dock.cancelBounce(id)` _OS X_ +### `app.dock.cancelBounce(id)` _macOS_ * `id` Integer Cancela o salto do `id`. -### `app.dock.setBadge(text)` _OS X_ +### `app.dock.setBadge(text)` _macOS_ * `text` String Define a string a ser exibida na área de *badging* do *dock*. -### `app.dock.getBadge()` _OS X_ +### `app.dock.getBadge()` _macOS_ Retorna a string da *badge* do *dock*. -### `app.dock.hide()` _OS X_ +### `app.dock.hide()` _macOS_ Esconde o ícone do *dock*. -### `app.dock.show()` _OS X_ +### `app.dock.show()` _macOS_ Exibe o ícone do *dock*. -### `app.dock.setMenu(menu)` _OS X_ +### `app.dock.setMenu(menu)` _macOS_ * `menu` Menu diff --git a/docs-translations/pt-BR/api/auto-updater.md b/docs-translations/pt-BR/api/auto-updater.md index 27c3ef3c074..f7c49db8ff5 100644 --- a/docs-translations/pt-BR/api/auto-updater.md +++ b/docs-translations/pt-BR/api/auto-updater.md @@ -6,9 +6,9 @@ Este módulo oferece uma interface para o framework de atualização automática Embora o `autoUpdater` ofereça uma API uniforme para diferentes plataformas, existem diferenças sutis em cada plataforma. -### OS X +### macOS -No OS X, o módulo `autoUpdater` é construído sobre o [Squirrel.Mac][squirrel-mac], o que significa que você não precisa de nenhuma configuração especial para fazê-lo funcionar. Para requerimentos de servidor, você pode ler [Server Support][server-support]. +No macOS, o módulo `autoUpdater` é construído sobre o [Squirrel.Mac][squirrel-mac], o que significa que você não precisa de nenhuma configuração especial para fazê-lo funcionar. Para requerimentos de servidor, você pode ler [Server Support][server-support]. ### Windows @@ -16,7 +16,7 @@ No Windows, você deve instalar seu aplicativo na máquina de um usuário antes O instalador gerado com Squirrel irá criar um ícone de atalho com um [Application User Model ID][app-user-model-id] no formato `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`, por exemplo: `com.squirrel.slack.Slack` e `com.squirrel.code.Code`. Você precisa usar o mesmo ID para seu aplicativo a API `app.setAppUserModelId`, senão o Windows não conseguirá fixar seu aplicativo corretamente na barra de tarefas. -A configuração do servidor também é diferente do OS X. Você pode ler a documentação do [Squirrel.Windows][squirrel-windows] para mais detalhes. +A configuração do servidor também é diferente do macOS. Você pode ler a documentação do [Squirrel.Windows][squirrel-windows] para mais detalhes. ### Linux diff --git a/docs-translations/pt-BR/api/browser-window.md b/docs-translations/pt-BR/api/browser-window.md index 5ebfa663772..4360296ffe6 100644 --- a/docs-translations/pt-BR/api/browser-window.md +++ b/docs-translations/pt-BR/api/browser-window.md @@ -38,7 +38,7 @@ Ela cria uma nova `BrowserWindow` com propriedades nativas definidas pelo `optio * `maxHeight` Integer - Altura máxima da janela. O padrão é sem limites. * `resizable` Boolean - Se é possível modificar o tamanho da janela. O padrão é `true`. * `alwaysOnTop` Boolean - Se a janela deve sempre ficar à frente de outras janelas. O padrão é `false`. -* `fullscreen` Boolean - Se a janela deve estar em tela cheia. Quando definido como `false`, o botão de tela cheia estará escondido ou desabilitado no OS X. O padrão é `false`. +* `fullscreen` Boolean - Se a janela deve estar em tela cheia. Quando definido como `false`, o botão de tela cheia estará escondido ou desabilitado no macOS. O padrão é `false`. * `skipTaskbar` Boolean - Se deve mostrar a janela na barra de tarefas. O padrão é `false`. * `kiosk` Boolean - Modo *kiosk*. O padrão é `false`. * `title` String - Título padrão da janela. O padrão é `"Electron"`. @@ -55,8 +55,8 @@ Ela cria uma nova `BrowserWindow` com propriedades nativas definidas pelo `optio * `type` String - Define o tipo da janela, que aplica propriedades adicionais específicas da plataforma. Por padrão é indefinido e será criada uma janela de aplicativo comum. Possíveis valores: * No Linux, os tipos possíveis são `desktop`, `dock`, `toolbar`, `splash`, `notification`. - * No OS X, os tipos possíveis são `desktop`, `textured`. O tipo `textured` adiciona a aparência degradê metálica (`NSTexturedBackgroundWindowMask`). O tipo `desktop` coloca a janela no nível do fundo de tela do desktop (`kCGDesktopWindowLevel - 1`). Note que a janela `desktop` não irá receber foco, eventos de teclado ou mouse, mas você pode usar `globalShortcut` para receber entrada de dados ocasionalmente. -* `titleBarStyle` String, OS X - Define o estilo da barra de título da janela. Esta opção está suportada a partir da versão OS X 10.10 Yosemite. Há três possíveis valores: + * No macOS, os tipos possíveis são `desktop`, `textured`. O tipo `textured` adiciona a aparência degradê metálica (`NSTexturedBackgroundWindowMask`). O tipo `desktop` coloca a janela no nível do fundo de tela do desktop (`kCGDesktopWindowLevel - 1`). Note que a janela `desktop` não irá receber foco, eventos de teclado ou mouse, mas você pode usar `globalShortcut` para receber entrada de dados ocasionalmente. +* `titleBarStyle` String, macOS - Define o estilo da barra de título da janela. Esta opção está suportada a partir da versão macOS 10.10 Yosemite. Há três possíveis valores: * `default` ou não definido, resulta na barra de título cinza opaca padrão do Mac. * `hidden` resulta numa barra de título oculta e a janela de conteúdo no tamanho máximo, porém a barra de título ainda possui os controles padrões de janela ("semáforo") no canto superior esquerdo. * `hidden-inset` resulta numa barra de título oculta com uma aparência alternativa onde os botões de semáforo estão ligeiramente mais longe do canto da janela. @@ -165,9 +165,9 @@ Emitido quando o tamanho da janela está sendo alterado. Emitido quando está sendo movida para uma nova posição. -__Note__: No OS X este evento é apenas um apelido de `moved`. +__Note__: No macOS este evento é apenas um apelido de `moved`. -### Evento: 'moved' _OS X_ +### Evento: 'moved' _macOS_ Emitido uma vez quando a janela é movida para uma nova posição. @@ -331,7 +331,7 @@ Define se a janela deve estar em modo tela cheia. Retorna um boolean, indicando se a janela está em modo tela cheia. -### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_ +### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_ * `aspectRatio` A proporção que queremos manter para uma porção do conteúdo da *view*. * `extraSize` Object (opcional) - O tamanho extra não incluído enquanto a proporção é mantida. Propriedades: @@ -493,23 +493,23 @@ Desengancha a mensagem de janela. Desengancha todas as mensagens de janela. -### `win.setRepresentedFilename(filename)` _OS X_ +### `win.setRepresentedFilename(filename)` _macOS_ * `filename` String Define o endereço do arquivo que a janela representa, e o ícone do arquivo será exibido na barra de título da janela. -### `win.getRepresentedFilename()` _OS X_ +### `win.getRepresentedFilename()` _macOS_ Retorna o endereço do arquivo que a janela representa. -### `win.setDocumentEdited(edited)` _OS X_ +### `win.setDocumentEdited(edited)` _macOS_ * `edited` Boolean Define se o documento da janela foi editado, e o ícone na barra de título se torna cinza quando definido como `true`. -### `win.isDocumentEdited()` _OS X_ +### `win.isDocumentEdited()` _macOS_ Retorna um boolean indicando se o documento da janela foi editado. @@ -581,7 +581,7 @@ Adiciona uma barra de ferramentes miniatura com um conjunto de botões específi O número de botões na barra de ferramentas miniatura não deve ser maior que 7 devido ao espaço limitado. Uma vez que você define a barra de ferramentas miniatura, ela não pode ser removida por causa da limitação da plataforma. Mas você pode chamar a API com um array vazio para limpar todos os botões. -### `win.showDefinitionForSelection()` _OS X_ +### `win.showDefinitionForSelection()` _macOS_ Mostra um dicionário *pop-up* que procura a palavra selecionada na página. diff --git a/docs-translations/pt-BR/api/process.md b/docs-translations/pt-BR/api/process.md index 71502de80d6..814c4c15e31 100644 --- a/docs-translations/pt-BR/api/process.md +++ b/docs-translations/pt-BR/api/process.md @@ -40,7 +40,7 @@ O objeto `process` tem os seguintes métodos: Faz com que o *thread* principal do processo congele. -### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_ +### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs-translations/pt-BR/styleguide.md b/docs-translations/pt-BR/styleguide.md index 817fa3c81e3..40a3a8a7f10 100644 --- a/docs-translations/pt-BR/styleguide.md +++ b/docs-translations/pt-BR/styleguide.md @@ -23,7 +23,7 @@ Estas são as formas que escrevemos a documentação do Electron. - Argumentos opcionais são indicados quando chamado na lista. - Comprimento da linha é de 80 caracteres com colunas quebradas. - Métodos específicos para uma plataforma são postos em itálico seguindo o cabeçalho do método. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` ## Lendo a documentação do Electron diff --git a/docs-translations/pt-BR/tutorial/application-distribution.md b/docs-translations/pt-BR/tutorial/application-distribution.md index f5a87d532c5..3bff230dae9 100644 --- a/docs-translations/pt-BR/tutorial/application-distribution.md +++ b/docs-translations/pt-BR/tutorial/application-distribution.md @@ -63,7 +63,7 @@ antes de distribuí-lo aos usuários. Você pode renomear `electron.exe` para o nome que desejar e editar o seu ícone e outras informações com ferramentas como [rcedit](https://github.com/atom/rcedit). -### OS X +### macOS Você pode renomear `Electron.app` para o nome que desejar e também pode mudar o nome do `CFBundleDisplayName`, `CFBundleIdentifier` e os campos em `CFBundleName` diff --git a/docs-translations/pt-BR/tutorial/desktop-environment-integration.md b/docs-translations/pt-BR/tutorial/desktop-environment-integration.md index 20a78d32d53..bf1e35969b2 100644 --- a/docs-translations/pt-BR/tutorial/desktop-environment-integration.md +++ b/docs-translations/pt-BR/tutorial/desktop-environment-integration.md @@ -8,9 +8,9 @@ menu customizado na dock. Este guia explica como integrar suas aplicações no ambiente desktop com a API do Electron. -## Documentos Recentes (Windows & OS X) +## Documentos Recentes (Windows & macOS) -O Windows e o OS X disponibilizam um acesso fácil para a lista de arquivos +O Windows e o macOS disponibilizam um acesso fácil para a lista de arquivos abertos recentemente pela aplicação através do JumpList ou Dock Menu respectivamente. __JumpList:__ @@ -48,14 +48,14 @@ Quando um usuário clica em um arquivo na JumpList, uma nova instância da sua a deve ser iniciada com o caminho do arquivo adicionado como um argumento de linha de comando. -### Notas para OS X +### Notas para macOS Quando um arquivo for requisitado pelo menu de documentos recentes, o evento `open-file` do módulo `app` irá ser emitido. -## Dock Menu customizado (OS X) +## Dock Menu customizado (macOS) -OS X permite que desenvolvedores especifiquem um menu customizado para a dock, +macOS permite que desenvolvedores especifiquem um menu customizado para a dock, que normalmente contém alguns atalhos para as funcionalidades mais utilizadas da sua aplicação. @@ -64,7 +64,7 @@ __Dock menu do Terminal.app:__ Para criar seu Dock Menu customizado, você pode usar a API `app.dock.setMenu`, -ela está disponível apenas no OS X: +ela está disponível apenas no macOS: ```javascript var app = require('app'); @@ -106,7 +106,7 @@ __Tarefas do Internet Explorer:__ ![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png) -Ao contrário do Menu Dock no OS X que é um verdadeiro menu, tarefas do usuário no Windows +Ao contrário do Menu Dock no macOS que é um verdadeiro menu, tarefas do usuário no Windows funcionam como atalhos, de uma forma que quando o usuário clica em uma tarefa, um programa deve ser executado com os argumentos especificados. @@ -226,9 +226,9 @@ var window = new BrowserWindow({...}); window.setProgressBar(0.5); ``` -## Representação do arquivo na janela (OS X) +## Representação do arquivo na janela (macOS) -No OS X, uma janela pode possuir a representação de um arquivo na barra de título, +No macOS, uma janela pode possuir a representação de um arquivo na barra de título, permitindo que ao usuário acionar um Command-Click ou Control-Click sobre o título da janela, uma pop-up de navegação entre arquivos é exibida. diff --git a/docs-translations/pt-BR/tutorial/quick-start.md b/docs-translations/pt-BR/tutorial/quick-start.md index 6a21123ecf6..ad28b4f9210 100644 --- a/docs-translations/pt-BR/tutorial/quick-start.md +++ b/docs-translations/pt-BR/tutorial/quick-start.md @@ -88,7 +88,7 @@ var mainWindow = null; // Sair quando todas as janelas estiverem fechadas. app.on('window-all-closed', function() { - // No OS X é comum para as aplicações na barra de menu + // No macOS é comum para as aplicações na barra de menu // continuarem ativas até que o usuário saia explicitamente // com Cmd + Q if (process.platform != 'darwin') { @@ -173,7 +173,7 @@ $ .\electron\electron.exe seu-app\ $ ./electron/electron seu-app/ ``` -#### OS X +#### macOS ```bash $ ./Electron.app/Contents/MacOS/Electron seu-app/ diff --git a/docs-translations/pt-BR/tutorial/supported-platforms.md b/docs-translations/pt-BR/tutorial/supported-platforms.md index 0fc42179bb9..1db405257da 100644 --- a/docs-translations/pt-BR/tutorial/supported-platforms.md +++ b/docs-translations/pt-BR/tutorial/supported-platforms.md @@ -2,9 +2,9 @@ As plataformas suportadas por Electron são: -### OS X +### macOS -Somente binarios em 64bit são construidos para OS X e a versão mínima suportada é OS X 10.9. +Somente binarios em 64bit são construidos para macOS e a versão mínima suportada é macOS 10.9. ### Windows Suporte para Windows 7 ou superior, versões anteriores não são suportados (e não ira funcionar) diff --git a/docs-translations/pt-BR/tutorial/using-pepper-flash-plugin.md b/docs-translations/pt-BR/tutorial/using-pepper-flash-plugin.md index 7ffba7cc336..2f87b067d66 100644 --- a/docs-translations/pt-BR/tutorial/using-pepper-flash-plugin.md +++ b/docs-translations/pt-BR/tutorial/using-pepper-flash-plugin.md @@ -6,7 +6,7 @@ habilitado em sua aplicação. ## Prepare uma cópia do plugin Flash -Tanto no OS X como no Linux, os detalhes do plugin Pepper Flash podem ser +Tanto no macOS como no Linux, os detalhes do plugin Pepper Flash podem ser encontrados navegando por `chrome://plugins` no navegador Chrome. Essa localização e versão são úteis para o suporte do plugin Electron's Pepper Flash. Você pode também copiar para outra localização. @@ -36,7 +36,7 @@ app.on('window-all-closed', function() { // Epecifica o caminho do flash. // No Windows, deve ser /path/to/pepflashplayer.dll -// No OS X, /path/to/PepperFlashPlayer.plugin +// No macOS, /path/to/PepperFlashPlayer.plugin // No Linux, /path/to/libpepflashplayer.so app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so'); diff --git a/docs-translations/ru-RU/README.md b/docs-translations/ru-RU/README.md index d2e9d532246..5a358eac9f6 100644 --- a/docs-translations/ru-RU/README.md +++ b/docs-translations/ru-RU/README.md @@ -75,7 +75,7 @@ * [Структура папок с исходным кодом](development/source-code-directory-structure.md) * [Technical Differences to NW.js (formerly node-webkit)](development/atom-shell-vs-node-webkit.md) * [Обзор системы сборки](development/build-system-overview.md) -* [Инструкции по сборке (OS X)](development/build-instructions-osx.md) +* [Инструкции по сборке (macOS)](development/build-instructions-osx.md) * [Инструкции по сборке (Windows)](development/build-instructions-windows.md) * [Инструкции по сборке (Linux)](development/build-instructions-linux.md) * [Настройка сервера символов для отладчика](development/setting-up-symbol-server.md) diff --git a/docs-translations/ru-RU/tutorial/application-distribution.md b/docs-translations/ru-RU/tutorial/application-distribution.md index 5ed04b5e767..7659523caed 100644 --- a/docs-translations/ru-RU/tutorial/application-distribution.md +++ b/docs-translations/ru-RU/tutorial/application-distribution.md @@ -1,11 +1,11 @@ # Распространение приложения Чтобы разпространять ваше приложение на Electron, папка с вашим приложением -должна называться `app` и находиться в папке ресурсов Electron (в OS X это +должна называться `app` и находиться в папке ресурсов Electron (в macOS это `Electron.app/Contents/Resources/`, в Linux и Windows - `resources/`), вот так: -Для OS X: +Для macOS: ```text electron/Electron.app/Contents/Resources/app/ @@ -38,7 +38,7 @@ electron/resources/app после чего Electron попробует считать ресурсы и запустить архив. -Для OS X: +Для macOS: ```text electron/Electron.app/Contents/Resources/ @@ -64,7 +64,7 @@ electron/resources/ Вы можете переименовать `electron.exe` как пожелаете и поменять иконку и прочую информацию приложениями вроде [rcedit](https://github.com/atom/rcedit). -### OS X +### macOS Вы можете переименовать `Electron.app` как пожелаете, а также изменить поля `CFBundleDisplayName`, `CFBundleIdentifier` и `CFBundleName` в следующих diff --git a/docs-translations/ru-RU/tutorial/mac-app-store-submission-guide.md b/docs-translations/ru-RU/tutorial/mac-app-store-submission-guide.md index 598f3233728..6b711e55cbc 100644 --- a/docs-translations/ru-RU/tutorial/mac-app-store-submission-guide.md +++ b/docs-translations/ru-RU/tutorial/mac-app-store-submission-guide.md @@ -85,7 +85,7 @@ productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH" ``` -Если вы только начали разрабатывать под Mac OS X, то мы советуем Вам прочитать [App SandBox](https://developer.apple.com/library/ios/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html "Ссылка для новичков в разработке приложений для Mac OS X") +Если вы только начали разрабатывать под macOS, то мы советуем Вам прочитать [App SandBox](https://developer.apple.com/library/ios/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html "Ссылка для новичков в разработке приложений для macOS") ## Обновление приложения diff --git a/docs-translations/ru-RU/tutorial/quick-start.md b/docs-translations/ru-RU/tutorial/quick-start.md index b8041b5e856..c08e6726470 100644 --- a/docs-translations/ru-RU/tutorial/quick-start.md +++ b/docs-translations/ru-RU/tutorial/quick-start.md @@ -113,7 +113,7 @@ app.on('ready', createWindow) // Выйти, если все окна закрыты app.on('window-all-closed', function () { - //На OS X приложение и его строка меню обычно остаются активными, + //На macOS приложение и его строка меню обычно остаются активными, //пока пользователь не завершит их с помощью `Cmd + Q`. if (process.platform !== 'darwin') { app.quit() @@ -121,7 +121,7 @@ app.on('window-all-closed', function () { }) app.on('activate', function () { - //На OS X приложение обычно пересоздаёт окно, когда + //На macOS приложение обычно пересоздаёт окно, когда //пользователь кликает на его иконку в доке, если не открыто //других окон. if (mainWindow === null) { @@ -192,7 +192,7 @@ $ .\electron\electron.exe your-app\ $ ./electron/electron your-app/ ``` -#### OS X +#### macOS ```bash $ ./Electron.app/Contents/MacOS/Electron your-app/ diff --git a/docs-translations/ru-RU/tutorial/supported-platforms.md b/docs-translations/ru-RU/tutorial/supported-platforms.md index 8321ddb7bec..0c929daa119 100644 --- a/docs-translations/ru-RU/tutorial/supported-platforms.md +++ b/docs-translations/ru-RU/tutorial/supported-platforms.md @@ -2,9 +2,9 @@ Следующие платформы поддерживаются Electron: -### OS X +### macOS -Поддерживает только 64-x битные OS X. Минимально поддерживаемой версией является OS X 10.9 +Поддерживает только 64-x битные macOS. Минимально поддерживаемой версией является macOS 10.9 ### Windows diff --git a/docs-translations/th-TH/README.md b/docs-translations/th-TH/README.md index 3b9f5207711..0a1863674ab 100644 --- a/docs-translations/th-TH/README.md +++ b/docs-translations/th-TH/README.md @@ -66,7 +66,7 @@ * [โครงสร้างไดเรคทอรี่ของซอร์สโค้ด](development/source-code-directory-structure.md) * [ความแตกต่างทางเทคนิคจาก NW.js (หรือ node-webkit)](development/atom-shell-vs-node-webkit.md) * [ภาพรวมการสร้างระบบ](development/build-system-overview.md) -* [ขั้นตอนการสร้าง (OS X)](development/build-instructions-osx.md) +* [ขั้นตอนการสร้าง (macOS)](development/build-instructions-osx.md) * [ขั้นตอนการสร้าง (Windows)](development/build-instructions-windows.md) * [ขั้นตอนการสร้าง (Linux)](development/build-instructions-linux.md) * [Setting Up Symbol Server in debugger](development/setting-up-symbol-server.md) diff --git a/docs-translations/tr-TR/README.md b/docs-translations/tr-TR/README.md index b055e63f5af..5717a5cea32 100644 --- a/docs-translations/tr-TR/README.md +++ b/docs-translations/tr-TR/README.md @@ -79,7 +79,7 @@ Bir problem(issue) bildirmeden önce sıkça sorulan sorulara göz atın: * [Kaynak Kod Dizin Yapısı](https://github.com/electron/electron/tree/master/docs/development/source-code-directory-structure.md) * [NW.js(node-webkit adıyla bilinen) İle Arasındaki Teknik Farklılıklar](https://github.com/electron/electron/tree/master/docs/development/atom-shell-vs-node-webkit.md) * [Build Sisyem Genel Bakış](https://github.com/electron/electron/tree/master/docs/development/build-system-overview.md) -* [(OS X) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-osx.md) +* [(macOS) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-osx.md) * [(Windows) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-windows.md) * [(Linux) Build Komutları](https://github.com/electron/electron/tree/master/docs/development/build-instructions-linux.md) * [(Windows) Hata Ayıklama Komutları](https://github.com/electron/electron/tree/master/docs/development/debug-instructions-windows.md) diff --git a/docs-translations/tr-TR/api/accelerator.md b/docs-translations/tr-TR/api/accelerator.md index 9105e5c6e46..be1acfbed1c 100644 --- a/docs-translations/tr-TR/api/accelerator.md +++ b/docs-translations/tr-TR/api/accelerator.md @@ -12,10 +12,10 @@ Hızlandırıcılar `+` karakteriyle birden fazla niteleyici ile kombinlenebilir ## Platform bilgileri Linux ve Windows'ta `Command` tuşu herhangi bir etki göstermez. Bunun yerine -`CommandOrControl` niteleyicisini kullanın. Bu işlem OS X'te `Command`, +`CommandOrControl` niteleyicisini kullanın. Bu işlem macOS'te `Command`, Linux ve Windows'ta `Control` tuşunun işlevini sağlar. `Alt` ise tüm platformlarda mevcuttur. -`Super` tuşu Windows ve Linux'te `Windows` tuşuna, OS X'te ise `Cmd` tuşuna eşleştirilmiştir. +`Super` tuşu Windows ve Linux'te `Windows` tuşuna, macOS'te ise `Cmd` tuşuna eşleştirilmiştir. ## Mevcut düzenleyiciler diff --git a/docs-translations/tr-TR/styleguide.md b/docs-translations/tr-TR/styleguide.md index 5e8f7524072..e9092d1d7c8 100644 --- a/docs-translations/tr-TR/styleguide.md +++ b/docs-translations/tr-TR/styleguide.md @@ -24,7 +24,7 @@ Electron Dokümantasyonunu geliştirmek için aşağıdaki yöntemleri takip edi - Optional arguments are denoted when called out in list. - Line length is 80-column wrapped. - Platform specific methods are noted in italics following method header. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` - Prefer 'in the ___ process' over 'on' ### Dokümantasyon Çevirisi diff --git a/docs-translations/uk-UA/README.md b/docs-translations/uk-UA/README.md index ef503a8844a..8600bdcd773 100644 --- a/docs-translations/uk-UA/README.md +++ b/docs-translations/uk-UA/README.md @@ -77,7 +77,7 @@ * [Source Code Directory Structure](development/source-code-directory-structure.md) * [Technical Differences to NW.js (formerly node-webkit)](development/atom-shell-vs-node-webkit.md) * [Build System Overview](development/build-system-overview.md) -* [Build Instructions (OS X)](development/build-instructions-osx.md) +* [Build Instructions (macOS)](development/build-instructions-osx.md) * [Build Instructions (Windows)](development/build-instructions-windows.md) * [Build Instructions (Linux)](development/build-instructions-linux.md) * [Setting Up Symbol Server in debugger](development/setting-up-symbol-server.md) diff --git a/docs-translations/uk-UA/styleguide.md b/docs-translations/uk-UA/styleguide.md index 2a5907ec4ea..94c70e5ce25 100644 --- a/docs-translations/uk-UA/styleguide.md +++ b/docs-translations/uk-UA/styleguide.md @@ -24,7 +24,7 @@ or [writing Electron documentation](#writing-electron-documentation). - Optional arguments are denoted when called out in list. - Line length is 80-column wrapped. - Platform specific methods are noted in italics following method header. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` - Prefer 'in the ___ process' over 'on' ### Переклад документації diff --git a/docs-translations/zh-CN/README.md b/docs-translations/zh-CN/README.md index 58293e38470..d3948c2bd2b 100644 --- a/docs-translations/zh-CN/README.md +++ b/docs-translations/zh-CN/README.md @@ -73,7 +73,7 @@ * [源码目录结构](development/source-code-directory-structure.md) * [与 NW.js（原 node-webkit）在技术上的差异](development/atom-shell-vs-node-webkit.md) * [构建系统概览](development/build-system-overview.md) -* [构建步骤（OS X）](development/build-instructions-osx.md) +* [构建步骤（macOS）](development/build-instructions-osx.md) * [构建步骤（Windows）](development/build-instructions-windows.md) * [构建步骤（Linux）](development/build-instructions-linux.md) * [在调试中使用 Symbol Server](development/setting-up-symbol-server.md) diff --git a/docs-translations/zh-CN/api/accelerator.md b/docs-translations/zh-CN/api/accelerator.md index 06e7397c849..0b1e2cd3f4d 100644 --- a/docs-translations/zh-CN/api/accelerator.md +++ b/docs-translations/zh-CN/api/accelerator.md @@ -9,10 +9,10 @@ ## 运行平台相关的提示 -在 Linux 和 Windows 上，`Command` 键并不存在，因此我们通常用 `CommandOrControl` 来表示“在 OS X 下为 `Command` 键，但在 +在 Linux 和 Windows 上，`Command` 键并不存在，因此我们通常用 `CommandOrControl` 来表示“在 macOS 下为 `Command` 键，但在 Linux 和 Windows 下为 `Control` 键。 -`Super` 键是指 Linux 和 Windows 上的 `Windows` 键，但是在 OS X 下为 `Command` 键。 +`Super` 键是指 Linux 和 Windows 上的 `Windows` 键，但是在 macOS 下为 `Command` 键。 ## 可用的功能按键 diff --git a/docs-translations/zh-CN/api/app.md b/docs-translations/zh-CN/api/app.md index 24cb70e8420..c2f244f4388 100644 --- a/docs-translations/zh-CN/api/app.md +++ b/docs-translations/zh-CN/api/app.md @@ -18,7 +18,7 @@ app.on('window-all-closed', function() { ### 事件：'will-finish-launching' 当应用程序完成基础的启动的时候被触发。在 Windows 和 Linux 中， -`will-finish-launching` 事件与 `ready` 事件是相同的； 在 OS X 中， +`will-finish-launching` 事件与 `ready` 事件是相同的； 在 macOS 中， 这个时间相当于 `NSApplication` 中的 `applicationWillFinishLaunching` 提示。 你应该经常在这里为 `open-file` 和 `open-url` 设置监听器，并启动崩溃报告和自动更新。 @@ -65,7 +65,7 @@ app.on('window-all-closed', function() { 当应用程序正在退出时触发。 -### 事件：'open-file' _OS X_ +### 事件：'open-file' _macOS_ 返回： @@ -79,7 +79,7 @@ app.on('window-all-closed', function() { 如果你想处理这个事件，你应该调用 `event.preventDefault()` 。 在 Windows系统中, 你需要通过解析 process.argv 来获取文件路径。 -### 事件：'open-url' _OS X_ +### 事件：'open-url' _macOS_ 返回： @@ -90,7 +90,7 @@ app.on('window-all-closed', function() { 如果你想处理这个事件，你应该调用 `event.preventDefault()` 。 -### 事件：'activate' _OS X_ +### 事件：'activate' _macOS_ 返回： @@ -225,11 +225,11 @@ app.on('login', function(event, webContents, request, authInfo, callback) { 这个方法保证了所有的 `beforeunload` 和 `unload` 事件处理器被正确执行。假如一个窗口的 `beforeunload` 事件处理器返回 `false`，那么整个应用可能会取消退出。 -### `app.hide()` _OS X_ +### `app.hide()` _macOS_ 隐藏所有的应用窗口，不是最小化. -### `app.show()` _OS X_ +### `app.show()` _macOS_ 隐藏后重新显示所有的窗口，不会自动选中他们。 @@ -257,7 +257,7 @@ app.on('login', function(event, webContents, request, authInfo, callback) { * `appData` 当前用户的应用数据文件夹，默认对应： * `%APPDATA%` Windows 中 * `$XDG_CONFIG_HOME` or `~/.config` Linux 中 - * `~/Library/Application Support` OS X 中 + * `~/Library/Application Support` macOS 中 * `userData` 储存你应用程序设置文件的文件夹，默认是 `appData` 文件夹附加应用的名称 * `temp` 临时文件夹 * `exe` 当前的可执行文件 @@ -305,15 +305,15 @@ app.on('login', function(event, webContents, request, authInfo, callback) { 返回当前应用程序的语言。 -### `app.addRecentDocument(path)` _OS X_ _Windows_ +### `app.addRecentDocument(path)` _macOS_ _Windows_ * `path` String 在最近访问的文档列表中添加 `path`。 -这个列表由操作系统进行管理。在 Windows 中您可以通过任务条进行访问，在 OS X 中你可以通过 dock 菜单进行访问。 +这个列表由操作系统进行管理。在 Windows 中您可以通过任务条进行访问，在 macOS 中你可以通过 dock 菜单进行访问。 -### `app.clearRecentDocuments()` _OS X_ _Windows_ +### `app.clearRecentDocuments()` _macOS_ _Windows_ 清除最近访问的文档列表。 @@ -358,7 +358,7 @@ app.on('login', function(event, webContents, request, authInfo, callback) { 如果当前实例为第一个实例，那么在这个方法将会返回 `false` 来保证它继续运行。否则将会返回 `true` 来让它立刻退出。 -在 OS X 中，如果用户通过 Finder、`open-file` 或者 `open-url` 打开应用，系统会强制确保只有一个实例在运行。但是如果用户是通过 +在 macOS 中，如果用户通过 Finder、`open-file` 或者 `open-url` 打开应用，系统会强制确保只有一个实例在运行。但是如果用户是通过 命令行打开，这个系统机制会被忽略，所以你仍然需要靠这个方法来保证应用为单实例运行的。 下面是一个简单的例子。我们可以通过这个例子了解如何确保应用为单实例运行状态。 @@ -432,7 +432,7 @@ if (browserOptions.transparent) { **注意** 这个方法不会影响 `process.argv`。 -### `app.dock.bounce([type])` _OS X_ +### `app.dock.bounce([type])` _macOS_ * `type` String - 可选参数，可以是 `critical` 或 `informational`。默认为 `informational`。 @@ -442,37 +442,37 @@ if (browserOptions.transparent) { 这个方法返回的返回值表示这个请求的 ID。 -### `app.dock.cancelBounce(id)` _OS X_ +### `app.dock.cancelBounce(id)` _macOS_ * `id` Integer 取消这个 `id` 对应的请求。 -### `app.dock.setBadge(text)` _OS X_ +### `app.dock.setBadge(text)` _macOS_ * `text` String 设置应用在 dock 中显示的字符串。 -### `app.dock.getBadge()` _OS X_ +### `app.dock.getBadge()` _macOS_ 返回应用在 dock 中显示的字符串。 -### `app.dock.hide()` _OS X_ +### `app.dock.hide()` _macOS_ 隐藏应用在 dock 中的图标。 -### `app.dock.show()` _OS X_ +### `app.dock.show()` _macOS_ 显示应用在 dock 中的图标。 -### `app.dock.setMenu(menu)` _OS X_ +### `app.dock.setMenu(menu)` _macOS_ * `menu` [Menu](menu.md) 设置应用的 [dock 菜单][dock-menu]. -### `app.dock.setIcon(image)` _OS X_ +### `app.dock.setIcon(image)` _macOS_ * `image` [NativeImage](native-image.md) diff --git a/docs-translations/zh-CN/api/auto-updater.md b/docs-translations/zh-CN/api/auto-updater.md index f027fbc6e50..845b4c24d9b 100644 --- a/docs-translations/zh-CN/api/auto-updater.md +++ b/docs-translations/zh-CN/api/auto-updater.md @@ -6,9 +6,9 @@ 虽然 `autoUpdater` 模块提供了一套各平台通用的接口，但是在每个平台间依然会有一些微小的差异。 -### OS X +### macOS -在 OS X 上，`autoUpdater` 模块依靠的是内置的 [Squirrel.Mac][squirrel-mac]，这意味着你不需要依靠其他的设置就能使用。关于 +在 macOS 上，`autoUpdater` 模块依靠的是内置的 [Squirrel.Mac][squirrel-mac]，这意味着你不需要依靠其他的设置就能使用。关于 更新服务器的配置，你可以通过阅读 [Server Support][server-support] 这篇文章来了解。 ### Windows @@ -19,7 +19,7 @@ Squirrel 自动生成的安装向导会生成一个带 [Application User Model I Application User Model ID 的格式是 `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`, 比如 像 `com.squirrel.slack.Slack` 和 `com.squirrel.code.Code` 这样的。你应该在自己的应用中使用 `app.setAppUserModelId` 方法设置相同的 API，不然 Windows 将不能正确地把你的应用固定在任务栏上。 -服务器端的配置和 OS X 也是不一样的，你可以阅读 [Squirrel.Windows][squirrel-windows] 这个文档来获得详细信息。 +服务器端的配置和 macOS 也是不一样的，你可以阅读 [Squirrel.Windows][squirrel-windows] 这个文档来获得详细信息。 ### Linux diff --git a/docs-translations/zh-CN/api/browser-window.md b/docs-translations/zh-CN/api/browser-window.md index 0d720c42591..f2fe697c729 100644 --- a/docs-translations/zh-CN/api/browser-window.md +++ b/docs-translations/zh-CN/api/browser-window.md @@ -47,8 +47,8 @@ win.show(); * `maximizable` Boolean - 窗口是否可以最大化. 在 Linux 上无效. 默认为 `true`. * `closable` Boolean - 窗口是否可以关闭. 在 Linux 上无效. 默认为 `true`. * `alwaysOnTop` Boolean - 窗口是否总是显示在其他窗口之前. 在 Linux 上无效. 默认为 `false`. - * `fullscreen` Boolean - 窗口是否可以全屏幕. 当明确设置值为When `false` ，全屏化按钮将会隐藏，在 OS X 将禁用. 默认 `false`. - * `fullscreenable` Boolean - 在 OS X 上，全屏化按钮是否可用，默认为 `true`. + * `fullscreen` Boolean - 窗口是否可以全屏幕. 当明确设置值为When `false` ，全屏化按钮将会隐藏，在 macOS 将禁用. 默认 `false`. + * `fullscreenable` Boolean - 在 macOS 上，全屏化按钮是否可用，默认为 `true`. * `skipTaskbar` Boolean - 是否在任务栏中显示窗口. 默认是`false`. * `kiosk` Boolean - kiosk 方式. 默认为 `false`. * `title` String - 窗口默认title. 默认 `"Electron"`. @@ -62,7 +62,7 @@ win.show(); * `enableLargerThanScreen` Boolean - 是否允许允许改变窗口大小大于屏幕. 默认是 `false`. * `backgroundColor` String -窗口的 background color 值为十六进制,如 `#66CD00` 或 `#FFF` 或 `#80FFFFFF` (支持透明度). 默认为在 Linux 和 Windows 上为 `#000` (黑色) , Mac上为 `#FFF`(或透明). - * `hasShadow` Boolean - 窗口是否有阴影. 只在 OS X 上有效. 默认为 `true`. + * `hasShadow` Boolean - 窗口是否有阴影. 只在 macOS 上有效. 默认为 `true`. * `darkTheme` Boolean - 为窗口使用 dark 主题, 只在一些拥有 GTK+3 桌面环境上有效. 默认为 `false`. * `transparent` Boolean - 窗口 [透明](frameless-window.md). 默认为 `false`. @@ -74,13 +74,13 @@ win.show(); * Linux, 可用值为 `desktop`, `dock`, `toolbar`, `splash`, `notification`. -* OS X, 可用值为 `desktop`, `textured`. +* macOS, 可用值为 `desktop`, `textured`. * `textured` type 添加金属梯度效果 (`NSTexturedBackgroundWindowMask`). * `desktop` 设置窗口在桌面背景窗口水平 (`kCGDesktopWindowLevel - 1`). 注意桌面窗口不可聚焦, 不可不支持键盘和鼠标事件, 但是可以使用 `globalShortcut` 来解决输入问题. -`titleBarStyle` 只在 OS X 10.10 Yosemite 或更新版本上支持. +`titleBarStyle` 只在 macOS 10.10 Yosemite 或更新版本上支持. 可用值: * `default` 以及无值, 显示在 Mac 标题栏上为不透明的标准灰色. @@ -206,9 +206,9 @@ window.onbeforeunload = function(e) { 在窗口移动的时候触发. -注意：在 OS X 中别名为 `moved`. +注意：在 macOS 中别名为 `moved`. -### Event: 'moved' _OS X_ +### Event: 'moved' _macOS_ 在窗口移动的时候触发. @@ -242,11 +242,11 @@ someWindow.on('app-command', function(e, cmd) { }); ``` -### Event: 'scroll-touch-begin' _OS X_ +### Event: 'scroll-touch-begin' _macOS_ 在滚动条事件开始的时候触发. -### Event: 'scroll-touch-end' _OS X_ +### Event: 'scroll-touch-end' _macOS_ 在滚动条事件结束的时候触发. @@ -379,7 +379,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); 返回 boolean, 窗口是否全屏化. -### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_ +### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_ * `aspectRatio` 维持部分视图内容窗口的高宽比值. * `extraSize` Object (可选) - 维持高宽比值时不包含的额外size. @@ -398,7 +398,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); * `y` Integer * `width` Integer * `height` Integer -* `animate` Boolean (可选) _OS X_ +* `animate` Boolean (可选) _macOS_ 重新设置窗口的宽高值，并且移动到指定的 `x`, `y` 位置. @@ -410,7 +410,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); * `width` Integer * `height` Integer -* `animate` Boolean (可选) _OS X_ +* `animate` Boolean (可选) _macOS_ 重新设置窗口的宽高值. @@ -422,7 +422,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); * `width` Integer * `height` Integer -* `animate` Boolean (可选) _OS X_ +* `animate` Boolean (可选) _macOS_ 重新设置窗口客户端的宽高值（例如网页界面）. @@ -462,33 +462,33 @@ var win = new BrowserWindow({ width: 800, height: 600 }); 返回 boolean,窗口是否可以被用户改变size. -### `win.setMovable(movable)` _OS X_ _Windows_ +### `win.setMovable(movable)` _macOS_ _Windows_ * `movable` Boolean 设置窗口是否可以被用户拖动. Linux 无效. -### `win.isMovable()` _OS X_ _Windows_ +### `win.isMovable()` _macOS_ _Windows_ 返回 boolean,窗口是否可以被用户拖动. Linux 总是返回 `true`. -### `win.setMinimizable(minimizable)` _OS X_ _Windows_ +### `win.setMinimizable(minimizable)` _macOS_ _Windows_ * `minimizable` Boolean 设置窗口是否可以最小化. Linux 无效. -### `win.isMinimizable()` _OS X_ _Windows_ +### `win.isMinimizable()` _macOS_ _Windows_ 返回 boolean,窗口是否可以最小化. Linux 总是返回 `true`. -### `win.setMaximizable(maximizable)` _OS X_ _Windows_ +### `win.setMaximizable(maximizable)` _macOS_ _Windows_ * `maximizable` Boolean 设置窗口是否可以最大化. Linux 无效. -### `win.isMaximizable()` _OS X_ _Windows_ +### `win.isMaximizable()` _macOS_ _Windows_ 返回 boolean,窗口是否可以最大化. Linux 总是返回 `true`. @@ -502,13 +502,13 @@ var win = new BrowserWindow({ width: 800, height: 600 }); 返回 boolean,点击最大化按钮是否可以全屏或最大化窗口. -### `win.setClosable(closable)` _OS X_ _Windows_ +### `win.setClosable(closable)` _macOS_ _Windows_ * `closable` Boolean 设置窗口是否可以人为关闭. Linux 无效. -### `win.isClosable()` _OS X_ _Windows_ +### `win.isClosable()` _macOS_ _Windows_ 返回 boolean,窗口是否可以人为关闭. Linux 总是返回 `true`. @@ -530,7 +530,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); * `x` Integer * `y` Integer -* `animate` Boolean (可选) _OS X_ +* `animate` Boolean (可选) _macOS_ 移动窗口到对应的 `x` and `y` 坐标. @@ -576,7 +576,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); 以 `Buffer` 形式返回这个具体平台的窗口的句柄. -windows上句柄类型为 `HWND` ，OS X `NSView*` ， Linux `Window`. +windows上句柄类型为 `HWND` ，macOS `NSView*` ， Linux `Window`. ### `win.hookWindowMessage(message, callback)` _Windows_ @@ -601,23 +601,23 @@ windows上句柄类型为 `HWND` ，OS X `NSView*` ， Linux `Window`. 窗口消息全部不拦截. -### `win.setRepresentedFilename(filename)` _OS X_ +### `win.setRepresentedFilename(filename)` _macOS_ * `filename` String 设置窗口当前文件路径，并且将这个文件的图标放在窗口标题栏上. -### `win.getRepresentedFilename()` _OS X_ +### `win.getRepresentedFilename()` _macOS_ 获取窗口当前文件路径. -### `win.setDocumentEdited(edited)` _OS X_ +### `win.setDocumentEdited(edited)` _macOS_ * `edited` Boolean 明确指出窗口文档是否可以编辑，如果可以编辑则将标题栏的图标变成灰色. -### `win.isDocumentEdited()` _OS X_ +### `win.isDocumentEdited()` _macOS_ 返回 boolean,当前窗口文档是否可编辑. @@ -668,13 +668,13 @@ windows上句柄类型为 `HWND` ，OS X `NSView*` ， Linux `Window`. 向当前任务栏添加一个 16 x 16 像素的图标，通常用来覆盖一些应用的状态，或者直接来提示用户. -### `win.setHasShadow(hasShadow)` _OS X_ +### `win.setHasShadow(hasShadow)` _macOS_ * `hasShadow` (Boolean) 设置窗口是否应该有阴影.在Windows和Linux系统无效. -### `win.hasShadow()` _OS X_ +### `win.hasShadow()` _macOS_ 返回 boolean,设置窗口是否有阴影.在Windows和Linux系统始终返回 `true`. @@ -704,7 +704,7 @@ windows上句柄类型为 `HWND` ，OS X `NSView*` ， Linux `Window`. * `hidden` - button 对用户不可见. * `noninteractive` - button 可用但是不可响应; 也不显示按下的状态. 它的值意味着这是一个在通知单使用 button 的实例. -### `win.showDefinitionForSelection()` _OS X_ +### `win.showDefinitionForSelection()` _macOS_ 在界面查找选中文字时显示弹出字典. @@ -744,7 +744,7 @@ windows上句柄类型为 `HWND` ，OS X `NSView*` ， Linux `Window`. **注意:** 在 windows上始终返回 false. -### `win.setIgnoreMouseEvents(ignore)` _OS X_ +### `win.setIgnoreMouseEvents(ignore)` _macOS_ * `ignore` Boolean diff --git a/docs-translations/zh-CN/api/crash-reporter.md b/docs-translations/zh-CN/api/crash-reporter.md index 6f2de5e8459..f8422bf454c 100644 --- a/docs-translations/zh-CN/api/crash-reporter.md +++ b/docs-translations/zh-CN/api/crash-reporter.md @@ -37,7 +37,7 @@ crashReporter.start({ 只可以在使用其它 `crashReporter` APIs 之前使用这个方法. -**注意:** 在 OS X, Electron 使用一个新的 `crashpad` 客户端, 与 Windows 和 Linux 的 `breakpad` 不同. 为了开启崩溃点搜集，你需要在主进程和其它每个你需要搜集崩溃报告的渲染进程中调用 `crashReporter.start` API 来初始化 `crashpad`. +**注意:** 在 macOS, Electron 使用一个新的 `crashpad` 客户端, 与 Windows 和 Linux 的 `breakpad` 不同. 为了开启崩溃点搜集，你需要在主进程和其它每个你需要搜集崩溃报告的渲染进程中调用 `crashReporter.start` API 来初始化 `crashpad`. ### `crashReporter.getLastCrashReport()` diff --git a/docs-translations/zh-CN/api/dialog.md b/docs-translations/zh-CN/api/dialog.md index 3e77eeaa2a5..dd691fa6469 100644 --- a/docs-translations/zh-CN/api/dialog.md +++ b/docs-translations/zh-CN/api/dialog.md @@ -10,7 +10,7 @@ const dialog = require('electron').dialog; console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', 'multiSelections' ]})); ``` -**OS X 上的注意事项**: 如果你想像sheets一样展示对话框，只需要在`browserWindow` 参数中提供一个 `BrowserWindow` 的引用对象. +**macOS 上的注意事项**: 如果你想像sheets一样展示对话框，只需要在`browserWindow` 参数中提供一个 `BrowserWindow` 的引用对象. ## 方法 @@ -79,7 +79,7 @@ console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', ' * `message` String - message box 内容. * `detail` String - 额外信息. * `icon` [NativeImage](native-image.md) - * `cancelId` Integer - 当用户关闭对话框的时候，不是通过点击对话框的button，就返回值.默认值为对应 "cancel" 或 "no" 标签button 的索引值, 或者如果没有这种button，就返回0. 在 OS X 和 Windows 上， "Cancel" button 的索引值将一直是 `cancelId`, 不管之前是不是特别指出的. + * `cancelId` Integer - 当用户关闭对话框的时候，不是通过点击对话框的button，就返回值.默认值为对应 "cancel" 或 "no" 标签button 的索引值, 或者如果没有这种button，就返回0. 在 macOS 和 Windows 上， "Cancel" button 的索引值将一直是 `cancelId`, 不管之前是不是特别指出的. * `noLink` Boolean - 在 Windows ，Electron 将尝试识别哪个button 是普通 button (如 "Cancel" 或 "Yes"), 然后再对话框中以链接命令(command links)方式展现其它的 button . 这能让对话框展示得很炫酷.如果你不喜欢这种效果，你可以设置 `noLink` 为 `true`. * `callback` Function diff --git a/docs-translations/zh-CN/api/frameless-window.md b/docs-translations/zh-CN/api/frameless-window.md index 833f070ad27..eb9a889263c 100644 --- a/docs-translations/zh-CN/api/frameless-window.md +++ b/docs-translations/zh-CN/api/frameless-window.md @@ -14,9 +14,9 @@ const BrowserWindow = require('electron').BrowserWindow; var win = new BrowserWindow({ width: 800, height: 600, frame: false }); ``` -### OS X上的替代方案 +### macOS上的替代方案 -在Mac OS X 10.10 Yosemite或者更新的版本中，有一个替代方案去生成一个无边框窗口。 +在macOS 10.10 Yosemite或者更新的版本中，有一个替代方案去生成一个无边框窗口。 不同于设置`frame`为`false`会隐藏标题栏以及失去对窗口的控制，你可能想隐藏标题栏使你的页面内容显示在整个窗口上 ，同时又想保持对窗口的控制("traffic lights")。你可以通过指定`titleBarStyle`这一新选项达到目标: diff --git a/docs-translations/zh-CN/api/menu-item.md b/docs-translations/zh-CN/api/menu-item.md index 3d5eceedcb9..6d5d59d934e 100644 --- a/docs-translations/zh-CN/api/menu-item.md +++ b/docs-translations/zh-CN/api/menu-item.md @@ -36,7 +36,7 @@ * `minimize` - 最小化当前窗口 * `close` - 关闭当前窗口 -在 OS X 上，`role` 还可以有以下值： +在 macOS 上，`role` 还可以有以下值： * `about` - 匹配 `orderFrontStandardAboutPanel` 行为 * `hide` - 匹配 `hide` 行为 diff --git a/docs-translations/zh-CN/api/menu.md b/docs-translations/zh-CN/api/menu.md index 1997a293d24..ea2535cc8b0 100644 --- a/docs-translations/zh-CN/api/menu.md +++ b/docs-translations/zh-CN/api/menu.md @@ -211,16 +211,16 @@ Menu.setApplicationMenu(menu); * `menu` Menu -在 OS X 上设置应用菜单 `menu` . +在 macOS 上设置应用菜单 `menu` . 在windows 和 linux，是为每个窗口都在其顶部设置菜单 `menu`. -### `Menu.sendActionToFirstResponder(action)` _OS X_ +### `Menu.sendActionToFirstResponder(action)` _macOS_ * `action` String 发送 `action` 给应用的第一个响应器.这个用来模仿 Cocoa 菜单的默认行为，通常你只需要使用 `MenuItem` 的属性 `role`. -查看更多 OS X 的原生 action [OS X Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7) . +查看更多 macOS 的原生 action [macOS Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7) . ### `Menu.buildFromTemplate(template)` @@ -239,7 +239,7 @@ Menu.setApplicationMenu(menu); * `browserWindow` BrowserWindow (可选) - 默认为 `null`. * `x` Number (可选) - 默认为 -1. * `y` Number (**必须** 如果x设置了) - 默认为 -1. -* `positioningItem` Number (可选) _OS X_ - 在指定坐标鼠标位置下面的菜单项的索引. 默认为 +* `positioningItem` Number (可选) _macOS_ - 在指定坐标鼠标位置下面的菜单项的索引. 默认为 -1. 在 `browserWindow` 中弹出 context menu .你可以选择性地提供指定的 `x, y` 来设置菜单应该放在哪里,否则它将默认地放在当前鼠标的位置. @@ -261,13 +261,13 @@ Menu.setApplicationMenu(menu); 获取一个菜单项数组. -## OS X Application 上的菜单的注意事项 +## macOS Application 上的菜单的注意事项 -相对于windows 和 linux, OS X 上的应用菜单是完全不同的style，这里是一些注意事项，来让你的菜单项更原生化. +相对于windows 和 linux, macOS 上的应用菜单是完全不同的style，这里是一些注意事项，来让你的菜单项更原生化. ### 标准菜单 -在 OS X 上，有很多系统定义的标准菜单，例如 `Services` and +在 macOS 上，有很多系统定义的标准菜单，例如 `Services` and `Windows` 菜单.为了让你的应用更标准化，你可以为你的菜单的 `role` 设置值，然后 electron 将会识别他们并且让你的菜单更标准: * `window` @@ -276,12 +276,12 @@ Menu.setApplicationMenu(menu); ### 标准菜单项行为 -OS X 为一些菜单项提供了标准的行为方法，例如 `About xxx`, +macOS 为一些菜单项提供了标准的行为方法，例如 `About xxx`, `Hide xxx`, and `Hide Others`. 为了让你的菜单项的行为更标准化，你应该为菜单项设置 `role` 属性. ### 主菜单名 -在 OS X ，无论你设置的什么标签，应用菜单的第一个菜单项的标签始终未你的应用名字.想要改变它的话，你必须通过修改应用绑定的 `Info.plist` 文件来修改应用名字.更多信息参考[About Information +在 macOS ，无论你设置的什么标签，应用菜单的第一个菜单项的标签始终未你的应用名字.想要改变它的话，你必须通过修改应用绑定的 `Info.plist` 文件来修改应用名字.更多信息参考[About Information Property List Files][AboutInformationPropertyListFiles] . ## 为制定浏览器窗口设置菜单 (*Linux* *Windows*) diff --git a/docs-translations/zh-CN/api/native-image.md b/docs-translations/zh-CN/api/native-image.md index 3644ff0b8bc..aa544d07dc3 100644 --- a/docs-translations/zh-CN/api/native-image.md +++ b/docs-translations/zh-CN/api/native-image.md @@ -63,7 +63,7 @@ var appIcon = new Tray('/Users/somebody/images/icon.png'); 最常见的用力是将模板图片用到菜单栏图片上，所以它可以同时适应亮、黑不同的菜单栏. -**注意:** 模板图片只在 OS X 上可用. +**注意:** 模板图片只在 macOS 上可用. 为了将图片标识为一个模板图片，它的文件名应当以 `Template` 结尾. 例如: @@ -121,9 +121,9 @@ var image = nativeImage.createFromPath('/Users/somebody/images/icon.png'); 返回图片数据的 URL. -### `image.getNativeHandle()` _OS X_ +### `image.getNativeHandle()` _macOS_ -返回一个保存了 c 指针的 [Buffer][buffer] 来潜在处理原始图像.在OS X, 将会返回一个 `NSImage` 指针实例. +返回一个保存了 c 指针的 [Buffer][buffer] 来潜在处理原始图像.在macOS, 将会返回一个 `NSImage` 指针实例. 注意那返回的指针是潜在原始图像的弱指针，而不是一个复制，你_必须_ 确保与 `nativeImage` 的关联不间断 . diff --git a/docs-translations/zh-CN/api/process.md b/docs-translations/zh-CN/api/process.md index 28127776cf0..c52591c5429 100644 --- a/docs-translations/zh-CN/api/process.md +++ b/docs-translations/zh-CN/api/process.md @@ -41,7 +41,7 @@ process.once('loaded', function() { 使当前进程的主线程挂起. -### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_ +### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs-translations/zh-CN/api/tray.md b/docs-translations/zh-CN/api/tray.md index d5647871ac7..2d23857e595 100644 --- a/docs-translations/zh-CN/api/tray.md +++ b/docs-translations/zh-CN/api/tray.md @@ -68,9 +68,9 @@ appIcon.setContextMenu(contextMenu); 当tray icon被点击的时候发出事件. -__注意:__ `bounds` 只在 OS X 和 Windows 上起效. +__注意:__ `bounds` 只在 macOS 和 Windows 上起效. -### Event: 'right-click' _OS X_ _Windows_ +### Event: 'right-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -85,7 +85,7 @@ __注意:__ `bounds` 只在 OS X 和 Windows 上起效. 当tray icon被鼠标右键点击的时候发出事件. -### Event: 'double-click' _OS X_ _Windows_ +### Event: 'double-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -112,27 +112,27 @@ __注意:__ `bounds` 只在 OS X 和 Windows 上起效. 当tray 气泡关闭的时候发出事件，因为超时或人为关闭. -### Event: 'drop' _OS X_ +### Event: 'drop' _macOS_ 当tray icon上的任何可拖动项被删除的时候发出事件. -### Event: 'drop-files' _OS X_ +### Event: 'drop-files' _macOS_ * `event` * `files` Array - 已删除文件的路径. 当tray icon上的可拖动文件被删除的时候发出事件. -### Event: 'drag-enter' _OS X_ +### Event: 'drag-enter' _macOS_ 当一个拖动操作进入tray icon的时候发出事件. -### Event: 'drag-leave' _OS X_ +### Event: 'drag-leave' _macOS_ 当一个拖动操作离开tray icon的时候发出事件. Emitted when a drag operation exits the tray icon. -### Event: 'drag-end' _OS X_ +### Event: 'drag-end' _macOS_ 当一个拖动操作在tray icon上或其它地方停止拖动的时候发出事件. @@ -152,11 +152,11 @@ Emitted when a drag operation exits the tray icon. 让 `image` 与 tray icon 关联起来. -### `Tray.setPressedImage(image)` _OS X_ +### `Tray.setPressedImage(image)` _macOS_ * `image` [NativeImage](native-image.md) -当在 OS X 上按压 tray icon 的时候， 让 `image` 与 tray icon 关联起来. +当在 macOS 上按压 tray icon 的时候， 让 `image` 与 tray icon 关联起来. ### `Tray.setToolTip(toolTip)` @@ -164,13 +164,13 @@ Emitted when a drag operation exits the tray icon. 为 tray icon 设置 hover text. -### `Tray.setTitle(title)` _OS X_ +### `Tray.setTitle(title)` _macOS_ * `title` String 在状态栏沿着 tray icon 设置标题. -### `Tray.setHighlightMode(highlight)` _OS X_ +### `Tray.setHighlightMode(highlight)` _macOS_ * `highlight` Boolean @@ -185,7 +185,7 @@ Emitted when a drag operation exits the tray icon. 展示一个 tray balloon. -### `Tray.popUpContextMenu([menu, position])` _OS X_ _Windows_ +### `Tray.popUpContextMenu([menu, position])` _macOS_ _Windows_ * `menu` Menu (optional) * `position` Object (可选) - 上托位置. diff --git a/docs-translations/zh-CN/development/build-instructions-osx.md b/docs-translations/zh-CN/development/build-instructions-osx.md index 98f6648a359..d2052c27a54 100644 --- a/docs-translations/zh-CN/development/build-instructions-osx.md +++ b/docs-translations/zh-CN/development/build-instructions-osx.md @@ -1,10 +1,10 @@ -# Build Instructions (OS X) +# Build Instructions (macOS) -遵循下面的引导，在 OS X 上构建 Electron . +遵循下面的引导，在 macOS 上构建 Electron . ## 前提 -* OS X >= 10.8 +* macOS >= 10.8 * [Xcode](https://developer.apple.com/technologies/tools/) >= 5.1 * [node.js](http://nodejs.org) (外部) @@ -45,7 +45,7 @@ $ ./script/build.py -c D ## 32位支持 -在 OS X 上，构建 Electron 只支持 64位的，不支持 32位的 . +在 macOS 上，构建 Electron 只支持 64位的，不支持 32位的 . ## 测试 diff --git a/docs-translations/zh-CN/tutorial/application-distribution.md b/docs-translations/zh-CN/tutorial/application-distribution.md index 2dca19342ad..07c9c0d8748 100644 --- a/docs-translations/zh-CN/tutorial/application-distribution.md +++ b/docs-translations/zh-CN/tutorial/application-distribution.md @@ -1,10 +1,10 @@ # 应用部署 为了使用 Electron 部署你的应用程序，你存放应用程序的文件夹需要叫做 `app` 并且需要放在 Electron 的 -资源文件夹下（在 OS X 中是指 `Electron.app/Contents/Resources/`，在 Linux 和 Windows 中是指 `resources/`） +资源文件夹下（在 macOS 中是指 `Electron.app/Contents/Resources/`，在 Linux 和 Windows 中是指 `resources/`） 就像这样： -在 OS X 中: +在 macOS 中: ```text electron/Electron.app/Contents/Resources/app/ @@ -33,7 +33,7 @@ electron/resources/app 然后将其放到 Electron 的资源文件夹下，然后 Electron 就会试图读取这个库文件并从中启动。 如下所示： -在 OS X 中: +在 macOS 中: ```text electron/Electron.app/Contents/Resources/ @@ -59,7 +59,7 @@ electron/resources/ [rcedit](https://github.com/atom/rcedit) 编辑它的 icon 和其他信息。 -### OS X +### macOS 你可以将 `Electron.app` 改成任意你喜欢的名字，然后你也需要修改这些文件中的 `CFBundleDisplayName`， `CFBundleIdentifier` 以及 `CFBundleName` 字段。 diff --git a/docs-translations/zh-CN/tutorial/desktop-environment-integration.md b/docs-translations/zh-CN/tutorial/desktop-environment-integration.md index 3f946da34e1..ea92d8d44fe 100644 --- a/docs-translations/zh-CN/tutorial/desktop-environment-integration.md +++ b/docs-translations/zh-CN/tutorial/desktop-environment-integration.md @@ -3,7 +3,7 @@ 本章将会说明怎样使用 Electron APIs 把你的应用和桌面环境集成到一块。 -## Notifications (Windows, Linux, OS X) +## Notifications (Windows, Linux, macOS) 这三个操作系统都为用户提供了发送通知的方法。Electron让开发人员通过 [HTML5 Notification API](https://notifications.spec.whatwg.org/) @@ -38,14 +38,14 @@ Model ID][app-user-model-id]安装到开始屏幕上。需要注意的是，这 Specification][notification-spec]的桌面环境中显示，包括 Cinnamon, Enlightenment, Unity, GNOME, KDE。 -### OS X +### macOS -在OS X系统中，通知是直接转发的，你应该了解[Apple's Human Interface guidelines regarding notifications](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)。 +在macOS系统中，通知是直接转发的，你应该了解[Apple's Human Interface guidelines regarding notifications](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html)。 注意通知被限制在256个字节以内，如果超出，则会被截断。 -## 最近文档 (Windows & OS X) -Windows 和 OS X 提供获取最近文档列表的便捷方式，那就是打开跳转列表或者鱼眼菜单。 +## 最近文档 (Windows & macOS) +Windows 和 macOS 提供获取最近文档列表的便捷方式，那就是打开跳转列表或者鱼眼菜单。 跳转列表： ![JumpList][1] @@ -66,15 +66,15 @@ app.clearRecentDocuments(); ## Windows 需注意 为了这个特性在 Windows 上表现正常，你的应用需要被注册成为一种文件类型的句柄，否则，在你注册之前，文件不会出现在跳转列表。你可以在 [Application Registration][5] 里找到任何关于注册事宜的说明。 -## OS X 需注意 +## macOS 需注意 当一个文件被最近文件列表请求时，`app` 模块里的 `open-file` 事件将会被发出。 -## 自定义的鱼眼菜单(OS X) -OS X 可以让开发者定制自己的菜单，通常会包含一些常用特性的快捷方式。 +## 自定义的鱼眼菜单(macOS) +macOS 可以让开发者定制自己的菜单，通常会包含一些常用特性的快捷方式。 ### 菜单中的终端 ![Dock menu of Terminal.app][6] -使用 `app.dock.setMenu` API 来设置你的菜单，这仅在 OS X 上可行： +使用 `app.dock.setMenu` API 来设置你的菜单，这仅在 macOS 上可行： ```javascript var app = require('app'); var Menu = require('menu'); @@ -98,7 +98,7 @@ app.dock.setMenu(dockMenu); ### IE 的任务 ![IE][7] -不同于 OS X 的鱼眼菜单，Windows 上的用户任务表现得更像一个快捷方式，比如当用户点击一个任务，一个程序将会被传入特定的参数并且运行。 +不同于 macOS 的鱼眼菜单，Windows 上的用户任务表现得更像一个快捷方式，比如当用户点击一个任务，一个程序将会被传入特定的参数并且运行。 你可以使用 [app.setUserTasks][8] API 来设置你的应用中的用户任务： ```javascript @@ -177,7 +177,7 @@ Unity DE 也具有同样的特性，在运行器上显示进度条。 var window = new BrowserWindow({...}); window.setProgressBar(0.5); ``` -在 OS X，一个窗口可以设置它展示的文件，文件的图标可以出现在标题栏，当用户 Command-Click 或者 Control-Click 标题栏，文件路径弹窗将会出现。 +在 macOS，一个窗口可以设置它展示的文件，文件的图标可以出现在标题栏，当用户 Command-Click 或者 Control-Click 标题栏，文件路径弹窗将会出现。 ### 展示文件弹窗菜单： ![Represented file popup menu][16] diff --git a/docs-translations/zh-CN/tutorial/mac-app-store-submission-guide.md b/docs-translations/zh-CN/tutorial/mac-app-store-submission-guide.md index bf326169fb7..35dbb420c31 100644 --- a/docs-translations/zh-CN/tutorial/mac-app-store-submission-guide.md +++ b/docs-translations/zh-CN/tutorial/mac-app-store-submission-guide.md @@ -100,7 +100,7 @@ codesign -s "$APP_KEY" -f --entitlements "$PARENT_PLIST" "$APP_PATH" productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH" ``` -如果你是 OS X 下的应用沙箱使用新手，应当仔细阅读 Apple 的 [Enabling App Sandbox][enable-app-sandbox] 了解一些基础，然后在授权文件 (entitlements files) 内添加你的应用需要的许可。 +如果你是 macOS 下的应用沙箱使用新手，应当仔细阅读 Apple 的 [Enabling App Sandbox][enable-app-sandbox] 了解一些基础，然后在授权文件 (entitlements files) 内添加你的应用需要的许可。 ### 上传你的应用并检查提交 diff --git a/docs-translations/zh-CN/tutorial/quick-start.md b/docs-translations/zh-CN/tutorial/quick-start.md index 6ea9d6d5525..4330bde6336 100644 --- a/docs-translations/zh-CN/tutorial/quick-start.md +++ b/docs-translations/zh-CN/tutorial/quick-start.md @@ -77,7 +77,7 @@ app.on('ready', createWindow); // Quit when all windows are closed. app.on('window-all-closed', () => { - // On OS X it is common for applications and their menu bar + // On macOS it is common for applications and their menu bar // to stay active until the user quits explicitly with Cmd + Q if (process.platform !== 'darwin') { app.quit(); @@ -85,7 +85,7 @@ app.on('window-all-closed', () => { }); app.on('activate', () => { - // On OS X it's common to re-create a window in the app when the + // On macOS it's common to re-create a window in the app when the // dock icon is clicked and there are no other windows open. if (mainWindow === null) { createWindow(); @@ -136,7 +136,7 @@ $ .\electron\electron.exe your-app\ ```bash $ ./electron/electron your-app/ ``` -### OS X +### macOS ```bash $ ./Electron.app/Contents/MacOS/Electron your-app/ ``` diff --git a/docs-translations/zh-CN/tutorial/supported-platforms.md b/docs-translations/zh-CN/tutorial/supported-platforms.md index e03ccd82364..dde3f130c57 100644 --- a/docs-translations/zh-CN/tutorial/supported-platforms.md +++ b/docs-translations/zh-CN/tutorial/supported-platforms.md @@ -2,9 +2,9 @@ 以下的平台是 Electron 目前支持的： -### OS X +### macOS -对于 OS X 系统仅有64位的二进制文档，支持的最低版本是 OS X 10.8。 +对于 macOS 系统仅有64位的二进制文档，支持的最低版本是 macOS 10.8。 ### Windows diff --git a/docs-translations/zh-CN/tutorial/testing-on-headless-ci.md b/docs-translations/zh-CN/tutorial/testing-on-headless-ci.md index 7da98b0a1a6..b768467109f 100644 --- a/docs-translations/zh-CN/tutorial/testing-on-headless-ci.md +++ b/docs-translations/zh-CN/tutorial/testing-on-headless-ci.md @@ -14,10 +14,10 @@ Jenkins 或者类似的系统上测试基于Electron的应用时，需要进行 然后创建一个虚拟的xvfb屏幕并且导出一个指向他的名为`DISPLAY`的环境变量。Electron中的Chromium 会自动的去寻找`$DISPLAY`，所以你的应用不需要再去进行配置。这一步可以通过Paul Betts's的 [xvfb-maybe](https://github.com/paulcbetts/xvfb-maybe)实现自动化：如果系统需要，在`xvfb-maybe`前加上你的测试命令 -然后这个小工具会自动的设置xvfb。在Windows或者Mac OS X系统下，它不会执行任何东西。 +然后这个小工具会自动的设置xvfb。在Windows或者macOS系统下，它不会执行任何东西。 ``` -## On Windows or OS X, this just invokes electron-mocha +## On Windows or macOS, this just invokes electron-mocha ## On Linux, if we are in a headless environment, this will be equivalent ## to xvfb-run electron-mocha ./test/*.js xvfb-maybe electron-mocha ./test/*.js diff --git a/docs-translations/zh-CN/tutorial/using-pepper-flash-plugin.md b/docs-translations/zh-CN/tutorial/using-pepper-flash-plugin.md index ce1f210c5c9..c030720f37c 100644 --- a/docs-translations/zh-CN/tutorial/using-pepper-flash-plugin.md +++ b/docs-translations/zh-CN/tutorial/using-pepper-flash-plugin.md @@ -5,7 +5,7 @@ Electron 现在支持 Pepper Flash 插件。要在 Electron 里面使用 Pepper ## 保留一份 Flash 插件的副本 -在 OS X 和 Linux 上，你可以在 Chrome 浏览器的 `chrome://plugins` 页面上找到 Pepper +在 macOS 和 Linux 上，你可以在 Chrome 浏览器的 `chrome://plugins` 页面上找到 Pepper Flash 的插件信息。插件的路径和版本会对 Election 对其的支持有帮助。你也可以把插件 复制到另一个路径以保留一份副本。 @@ -19,7 +19,7 @@ Flash 的插件信息。插件的路径和版本会对 Election 对其的支持 ```javascript // Specify flash path. 设置 flash 路径 // On Windows, it might be /path/to/pepflashplayer.dll -// On OS X, /path/to/PepperFlashPlayer.plugin +// On macOS, /path/to/PepperFlashPlayer.plugin // On Linux, /path/to/libpepflashplayer.so app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so'); diff --git a/docs-translations/zh-CN/tutorial/using-widevine-cdm-plugin.md b/docs-translations/zh-CN/tutorial/using-widevine-cdm-plugin.md index d5df1646c48..25ce3bd525e 100644 --- a/docs-translations/zh-CN/tutorial/using-widevine-cdm-plugin.md +++ b/docs-translations/zh-CN/tutorial/using-widevine-cdm-plugin.md @@ -8,17 +8,17 @@ Electron 没有为 Widevine CDM 插件 配制许可 reasons, 为了获得它， __注意:__ Chrome 浏览器的主要版本必须和 Electron 使用的版本一样，否则插件不会有效，虽然 `navigator.plugins` 会显示你已经安装了它 . -### Windows & OS X +### Windows & macOS 在 Chrome 浏览器中打开 `chrome://components/` ，找到 `WidevineCdm` 并且确定它更新到最新版本，然后你可以从 `APP_DATA/Google/Chrome/WidevineCDM/VERSION/_platform_specific/PLATFORM_ARCH/` 路径找到所有的插件二进制文件 . `APP_DATA` 是系统存放数据的地方，在 Windows 上它是 -`%LOCALAPPDATA%`, 在 OS X 上它是 `~/Library/Application Support`. `VERSION` 是 +`%LOCALAPPDATA%`, 在 macOS 上它是 `~/Library/Application Support`. `VERSION` 是 Widevine CDM 插件的版本字符串, 类似 `1.4.8.866`. `PLATFORM` 是 `mac` 或 `win`. `ARCH` 是 `x86` 或 `x64`. 在 Windows，必要的二进制文件是 `widevinecdm.dll` and -`widevinecdmadapter.dll`, 在 OS X ，它们是 `libwidevinecdm.dylib` 和 +`widevinecdmadapter.dll`, 在 macOS ，它们是 `libwidevinecdm.dylib` 和 `widevinecdmadapter.plugin`. 你可以将它们复制到任何你喜欢的地方，但是它们必须要放在一起. ### Linux @@ -38,7 +38,7 @@ __注意:__ 虽然只有 `widevinecdmadapter` 的二进制文件传递给了 El ```javascript // You have to pass the filename of `widevinecdmadapter` here, it is -// * `widevinecdmadapter.plugin` on OS X, +// * `widevinecdmadapter.plugin` on macOS, // * `libwidevinecdmadapter.so` on Linux, // * `widevinecdmadapter.dll` on Windows. app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin'); diff --git a/docs-translations/zh-TW/README.md b/docs-translations/zh-TW/README.md index 29ed827c668..3924e1fa83c 100644 --- a/docs-translations/zh-TW/README.md +++ b/docs-translations/zh-TW/README.md @@ -66,7 +66,7 @@ * [源碼目錄結構](development/source-code-directory-structure.md) * [與 NW.js (原名node-webkit) 在技術上的差異](development/atom-shell-vs-node-webkit.md) * [構建系統概況](development/build-system-overview.md) -* [構建步驟 (OS X)](development/build-instructions-osx.md) +* [構建步驟 (macOS)](development/build-instructions-osx.md) * [構建步驟 (Windows)](development/build-instructions-windows.md) * [構建步驟 (Linux)](development/build-instructions-linux.md) * [在 debugger 中使用 symbol server](development/setting-up-symbol-server.md) diff --git a/docs-translations/zh-TW/api/process.md b/docs-translations/zh-TW/api/process.md index ba3dd245f7a..bb83f42b154 100644 --- a/docs-translations/zh-TW/api/process.md +++ b/docs-translations/zh-TW/api/process.md @@ -15,7 +15,7 @@ 會導致目前行程的主執行緒停住 -## process.setFdLimit(maxDescriptors) _OS X_ _Linux_ +## process.setFdLimit(maxDescriptors) _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs-translations/zh-TW/tutorial/application-distribution.md b/docs-translations/zh-TW/tutorial/application-distribution.md index 53561ecfda6..f26f97bf909 100644 --- a/docs-translations/zh-TW/tutorial/application-distribution.md +++ b/docs-translations/zh-TW/tutorial/application-distribution.md @@ -1,8 +1,8 @@ # 應用程式部署 -要部屬你的 Electron 應用程式，你需要把你的應用程式資料夾命名為 `app`，並放置於 Electron 的資源目錄下 (在 OS X 中位在 `Electron.app/Contents/Resources/` 而 Linux 和 Windows 的是在 `resources/`)，例如： +要部屬你的 Electron 應用程式，你需要把你的應用程式資料夾命名為 `app`，並放置於 Electron 的資源目錄下 (在 macOS 中位在 `Electron.app/Contents/Resources/` 而 Linux 和 Windows 的是在 `resources/`)，例如： -OS X: +macOS: ```text electron/Electron.app/Contents/Resources/app/ @@ -28,7 +28,7 @@ electron/resources/app 要使用 `asar` 壓縮檔來取代 `app` 資料夾，你需要重新命名該壓縮檔為 `app.asar`，然後如下所示把它放到 Electron 的資源目錄中，接著 Electron 就會試著讀取壓縮檔並從它開始執行。 -OS X: +macOS: ```text electron/Electron.app/Contents/Resources/ @@ -53,7 +53,7 @@ electron/resources/ 你可以重新命名 `electron.exe` 為任何你喜歡的名稱，然後透過像是 [rcedit](https://github.com/atom/rcedit) 的工具來編輯它的圖示(icon)和其他資訊。 -### OS X +### macOS 你可以重新命名 `Electron.app` 為任何你喜歡的名稱，另外你也需要重新命名下列檔案中的 `CFBundleDisplayName`、`CFBundleIdentifier` 和 `CFBundleName` 欄位： diff --git a/docs-translations/zh-TW/tutorial/mac-app-store-submission-guide.md b/docs-translations/zh-TW/tutorial/mac-app-store-submission-guide.md index e5fbda46dd5..b33ddeda405 100644 --- a/docs-translations/zh-TW/tutorial/mac-app-store-submission-guide.md +++ b/docs-translations/zh-TW/tutorial/mac-app-store-submission-guide.md @@ -74,7 +74,7 @@ codesign -fs "$APP_KEY" --entitlements parent.plist "$APP_PATH" productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH" ``` -如果你是第一次使用 OS X 下的應用程式沙盒(app sandboxing)，你應該也要閱讀 Apple 的 [Enabling App Sandbox][enable-app-sandbox] 以具備基本概念，然後把你的應用程式會用到的 key 的權限都加入管理權現的檔案中。 +如果你是第一次使用 macOS 下的應用程式沙盒(app sandboxing)，你應該也要閱讀 Apple 的 [Enabling App Sandbox][enable-app-sandbox] 以具備基本概念，然後把你的應用程式會用到的 key 的權限都加入管理權現的檔案中。 ### 上傳你的應用程式和提交檢視 diff --git a/docs-translations/zh-TW/tutorial/quick-start.md b/docs-translations/zh-TW/tutorial/quick-start.md index af98a0e580c..ec1f612868c 100644 --- a/docs-translations/zh-TW/tutorial/quick-start.md +++ b/docs-translations/zh-TW/tutorial/quick-start.md @@ -68,7 +68,7 @@ var mainWindow = null; // 當所有窗口被關閉了，退出。 app.on('window-all-closed', function() { -  // 在OS X 上，通常使用者在明確地按下 Cmd + Q 之前 +  // 在macOS 上，通常使用者在明確地按下 Cmd + Q 之前   // 應用會保持活動狀態   if (process.platform != 'darwin') {     app.quit(); @@ -147,7 +147,7 @@ $ .\electron\electron.exe your-app\ $ ./electron/electron your-app/ ``` -### OS X +### macOS ``` bash $ ./Electron.app/Contents/MacOS/Electron your-app/ diff --git a/docs-translations/zh-TW/tutorial/supported-platforms.md b/docs-translations/zh-TW/tutorial/supported-platforms.md index 225bc9b2b55..d17943761d9 100644 --- a/docs-translations/zh-TW/tutorial/supported-platforms.md +++ b/docs-translations/zh-TW/tutorial/supported-platforms.md @@ -2,9 +2,9 @@ Electron 已支援以下平台： -### OS X +### macOS -OS X 系統只有 64 位元的執行檔，且 OS X 的最低版本要求為 OS X 10.8。 +macOS 系統只有 64 位元的執行檔，且 macOS 的最低版本要求為 macOS 10.8。 ### Windows diff --git a/docs-translations/zh-TW/tutorial/using-pepper-flash-plugin.md b/docs-translations/zh-TW/tutorial/using-pepper-flash-plugin.md index e27554c5168..2e1ea49f021 100644 --- a/docs-translations/zh-TW/tutorial/using-pepper-flash-plugin.md +++ b/docs-translations/zh-TW/tutorial/using-pepper-flash-plugin.md @@ -4,7 +4,7 @@ Electron 現在支援 Pepper Flash 外掛，要在 Electron 中使用 Pepper Fla ## 準備一份 Flash 外掛 -在 OS X 和 Linux 上，Pepper Flash 外掛的細節可以透過查看 Chrome 瀏覽器中的 `chrome://plugins` 來得知，它的位置和版本對於 Electron 的 Pepper Flash 支援都有很大的幫助，你可以把它複製一份到別的位置。 +在 macOS 和 Linux 上，Pepper Flash 外掛的細節可以透過查看 Chrome 瀏覽器中的 `chrome://plugins` 來得知，它的位置和版本對於 Electron 的 Pepper Flash 支援都有很大的幫助，你可以把它複製一份到別的位置。 ## 加入 Electron 開關 @@ -16,7 +16,7 @@ Electron 命定列或是在應用程式的 ready 事件之前使用 `app.command ```javascript // 指定 Flash 路徑 // Windows 中可能是 /path/to/pepflashplayer.dll -// OS X 中 /path/to/PepperFlashPlayer.plugin +// macOS 中 /path/to/PepperFlashPlayer.plugin // Linux 中 /path/to/libpepflashplayer.so app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so'); diff --git a/docs/README.md b/docs/README.md index 1cbe32d8dd8..072e97cfc32 100644 --- a/docs/README.md +++ b/docs/README.md @@ -90,7 +90,7 @@ an issue: * [Source Code Directory Structure](development/source-code-directory-structure.md) * [Technical Differences to NW.js (formerly node-webkit)](development/atom-shell-vs-node-webkit.md) * [Build System Overview](development/build-system-overview.md) -* [Build Instructions (OS X)](development/build-instructions-osx.md) +* [Build Instructions (macOS)](development/build-instructions-osx.md) * [Build Instructions (Windows)](development/build-instructions-windows.md) * [Build Instructions (Linux)](development/build-instructions-linux.md) * [Debug Instructions (Windows)](development/debug-instructions-windows.md) diff --git a/docs/api/accelerator.md b/docs/api/accelerator.md index 1710d598e3d..1f760b46361 100644 --- a/docs/api/accelerator.md +++ b/docs/api/accelerator.md @@ -13,14 +13,14 @@ Examples: ## Platform notice On Linux and Windows, the `Command` key does not have any effect so -use `CommandOrControl` which represents `Command` on OS X and `Control` on +use `CommandOrControl` which represents `Command` on macOS and `Control` on Linux and Windows to define some accelerators. -Use `Alt` instead of `Option`. The `Option` key only exists on OS X, whereas +Use `Alt` instead of `Option`. The `Option` key only exists on macOS, whereas the `Alt` key is available on all platforms. The `Super` key is mapped to the `Windows` key on Windows and Linux and -`Cmd` on OS X. +`Cmd` on macOS. ## Available modifiers diff --git a/docs/api/app.md b/docs/api/app.md index 7082c76f251..c014395eb10 100644 --- a/docs/api/app.md +++ b/docs/api/app.md @@ -19,7 +19,7 @@ The `app` object emits the following events: ### Event: 'will-finish-launching' Emitted when the application has finished basic startup. On Windows and Linux, -the `will-finish-launching` event is the same as the `ready` event; on OS X, +the `will-finish-launching` event is the same as the `ready` event; on macOS, this event represents the `applicationWillFinishLaunching` notification of `NSApplication`. You would usually set up listeners for the `open-file` and `open-url` events here, and start the crash reporter and auto updater. @@ -73,7 +73,7 @@ Returns: Emitted when the application is quitting. -### Event: 'open-file' _OS X_ +### Event: 'open-file' _macOS_ Returns: @@ -92,7 +92,7 @@ You should call `event.preventDefault()` if you want to handle this event. On Windows, you have to parse `process.argv` (in the main process) to get the filepath. -### Event: 'open-url' _OS X_ +### Event: 'open-url' _macOS_ Returns: @@ -104,7 +104,7 @@ must be registered to be opened by your application. You should call `event.preventDefault()` if you want to handle this event. -### Event: 'activate' _OS X_ +### Event: 'activate' _macOS_ Returns: @@ -114,7 +114,7 @@ Returns: Emitted when the application is activated, which usually happens when the user clicks on the application's dock icon. -### Event: 'continue-activity' _OS X_ +### Event: 'continue-activity' _macOS_ Returns: @@ -314,14 +314,14 @@ app.exit(0) ### `app.focus()` -On Linux, focuses on the first visible window. On OS X, makes the application +On Linux, focuses on the first visible window. On macOS, makes the application the active app. On Windows, focuses on the application's first window. -### `app.hide()` _OS X_ +### `app.hide()` _macOS_ Hides all application windows without minimizing them. -### `app.show()` _OS X_ +### `app.show()` _macOS_ Shows application windows after they were hidden. Does not automatically focus them. @@ -343,7 +343,7 @@ You can request the following paths by the name: * `appData` Per-user application data directory, which by default points to: * `%APPDATA%` on Windows * `$XDG_CONFIG_HOME` or `~/.config` on Linux - * `~/Library/Application Support` on OS X + * `~/Library/Application Support` on macOS * `userData` The directory for storing your app's configuration files, which by default it is the `appData` directory appended with your app's name. * `temp` Temporary directory. @@ -403,20 +403,20 @@ Returns the current application locale. **Note:** On Windows you have to call it after the `ready` events gets emitted. -### `app.addRecentDocument(path)` _OS X_ _Windows_ +### `app.addRecentDocument(path)` _macOS_ _Windows_ * `path` String Adds `path` to the recent documents list. This list is managed by the OS. On Windows you can visit the list from the task -bar, and on OS X you can visit it from dock menu. +bar, and on macOS you can visit it from dock menu. -### `app.clearRecentDocuments()` _OS X_ _Windows_ +### `app.clearRecentDocuments()` _macOS_ _Windows_ Clears the recent documents list. -### `app.setAsDefaultProtocolClient(protocol)` _OS X_ _Windows_ +### `app.setAsDefaultProtocolClient(protocol)` _macOS_ _Windows_ * `protocol` String - The name of your protocol, without `://`. If you want your app to handle `electron://` links, call this method with `electron` as the @@ -428,31 +428,31 @@ system. Once registered, all links with `your-protocol://` will be opened with the current executable. The whole link, including protocol, will be passed to your application as a parameter. -**Note:** On OS X, you can only register protocols that have been added to +**Note:** On macOS, you can only register protocols that have been added to your app's `info.plist`, which can not be modified at runtime. You can however change the file with a simple text editor or script during build time. Please refer to [Apple's documentation][CFBundleURLTypes] for details. The API uses the Windows Registry and LSSetDefaultHandlerForURLScheme internally. -### `app.removeAsDefaultProtocolClient(protocol)` _OS X_ _Windows_ +### `app.removeAsDefaultProtocolClient(protocol)` _macOS_ _Windows_ * `protocol` String - The name of your protocol, without `://`. This method checks if the current executable as the default handler for a protocol (aka URI scheme). If so, it will remove the app as the default handler. -### `app.isDefaultProtocolClient(protocol)` _OS X_ _Windows_ +### `app.isDefaultProtocolClient(protocol)` _macOS_ _Windows_ * `protocol` String - The name of your protocol, without `://`. This method checks if the current executable is the default handler for a protocol (aka URI scheme). If so, it will return true. Otherwise, it will return false. -**Note:** On OS X, you can use this method to check if the app has been +**Note:** On macOS, you can use this method to check if the app has been registered as the default protocol handler for a protocol. You can also verify this by checking `~/Library/Preferences/com.apple.LaunchServices.plist` on the -OS X machine. Please refer to +macOS machine. Please refer to [Apple's documentation][LSCopyDefaultHandlerForURLScheme] for details. The API uses the Windows Registry and LSCopyDefaultHandlerForURLScheme internally. @@ -503,7 +503,7 @@ application and your app should continue loading. And returns `true` if your process has sent its parameters to another instance, and you should immediately quit. -On OS X the system enforces single instance automatically when users try to open +On macOS the system enforces single instance automatically when users try to open a second instance of your app in Finder, and the `open-file` and `open-url` events will be emitted for that. However when users start your app in command line the system's single instance mechanism will be bypassed and you have to @@ -538,7 +538,7 @@ app.on('ready', () => { Releases all locks that were created by `makeSingleInstance`. This will allow multiple instances of the application to once again run side by side. -### `app.setUserActivity(type, userInfo[, webpageURL])` _OS X_ +### `app.setUserActivity(type, userInfo[, webpageURL])` _macOS_ * `type` String - Uniquely identifies the activity. Maps to [`NSUserActivity.activityType`][activity-type]. @@ -549,7 +549,7 @@ multiple instances of the application to once again run side by side. Creates an `NSUserActivity` and sets it as the current activity. The activity is eligible for [Handoff][handoff] to another device afterward. -### `app.getCurrentActivityType()` _OS X_ +### `app.getCurrentActivityType()` _macOS_ Returns the type of the currently running activity. @@ -591,7 +591,7 @@ correctly. **Note:** This will not affect `process.argv`. -### `app.dock.bounce([type])` _OS X_ +### `app.dock.bounce([type])` _macOS_ * `type` String (optional) - Can be `critical` or `informational`. The default is `informational` @@ -605,43 +605,43 @@ or the request is canceled. Returns an ID representing the request. -### `app.dock.cancelBounce(id)` _OS X_ +### `app.dock.cancelBounce(id)` _macOS_ * `id` Integer Cancel the bounce of `id`. -### `app.dock.downloadFinished(filePath)` _OS X_ +### `app.dock.downloadFinished(filePath)` _macOS_ * `filePath` String Bounces the Downloads stack if the filePath is inside the Downloads folder. -### `app.dock.setBadge(text)` _OS X_ +### `app.dock.setBadge(text)` _macOS_ * `text` String Sets the string to be displayed in the dock’s badging area. -### `app.dock.getBadge()` _OS X_ +### `app.dock.getBadge()` _macOS_ Returns the badge string of the dock. -### `app.dock.hide()` _OS X_ +### `app.dock.hide()` _macOS_ Hides the dock icon. -### `app.dock.show()` _OS X_ +### `app.dock.show()` _macOS_ Shows the dock icon. -### `app.dock.setMenu(menu)` _OS X_ +### `app.dock.setMenu(menu)` _macOS_ * `menu` [Menu](menu.md) Sets the application's [dock menu][dock-menu]. -### `app.dock.setIcon(image)` _OS X_ +### `app.dock.setIcon(image)` _macOS_ * `image` [NativeImage](native-image.md) diff --git a/docs/api/auto-updater.md b/docs/api/auto-updater.md index ee26d07780a..46157d02e91 100644 --- a/docs/api/auto-updater.md +++ b/docs/api/auto-updater.md @@ -20,13 +20,13 @@ application by using one of these projects: Though `autoUpdater` provides a uniform API for different platforms, there are still some subtle differences on each platform. -### OS X +### macOS -On OS X, the `autoUpdater` module is built upon [Squirrel.Mac][squirrel-mac], +On macOS, the `autoUpdater` module is built upon [Squirrel.Mac][squirrel-mac], meaning you don't need any special setup to make it work. For server-side requirements, you can read [Server Support][server-support]. -**Note:** Your application must be signed for automatic updates on Mac OS X. +**Note:** Your application must be signed for automatic updates on macOS. This is a requirement of `Squirrel.Mac`. ### Windows @@ -42,7 +42,7 @@ The installer generated with Squirrel will create a shortcut icon with an same ID for your app with `app.setAppUserModelId` API, otherwise Windows will not be able to pin your app properly in task bar. -The server-side setup is also different from OS X. You can read the documents of +The server-side setup is also different from macOS. You can read the documents of [Squirrel.Windows][squirrel-windows] to get more details. ### Linux @@ -96,7 +96,7 @@ The `autoUpdater` object has the following methods: ### `autoUpdater.setFeedURL(url[, requestHeaders])` * `url` String -* `requestHeaders` Object _OS X_ - HTTP request headers. +* `requestHeaders` Object _macOS_ - HTTP request headers. Sets the `url` and initialize the auto updater. diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md index 2cae696a276..6aae7b0080a 100644 --- a/docs/api/browser-window.md +++ b/docs/api/browser-window.md @@ -101,9 +101,9 @@ It creates a new `BrowserWindow` with native properties as set by the `options`. other windows. Default is `false`. * `fullscreen` Boolean - Whether the window should show in fullscreen. When explicitly set to `false` the fullscreen button will be hidden or disabled - on OS X. Default is `false`. + on macOS. Default is `false`. * `fullscreenable` Boolean - Whether the window can be put into fullscreen - mode. On OS X, also whether the maximize/zoom button should toggle full + mode. On macOS, also whether the maximize/zoom button should toggle full screen mode or maximize window. Default is `true`. * `skipTaskbar` Boolean - Whether to show the window in taskbar. Default is `false`. @@ -129,7 +129,7 @@ It creates a new `BrowserWindow` with native properties as set by the `options`. like `#66CD00` or `#FFF` or `#80FFFFFF` (alpha is supported). Default is `#FFF` (white). * `hasShadow` Boolean - Whether window should have a shadow. This is only - implemented on OS X. Default is `true`. + implemented on macOS. Default is `true`. * `darkTheme` Boolean - Forces using dark theme for the window, only works on some GTK+3 desktop environments. Default is `false`. * `transparent` Boolean - Makes the window [transparent](frameless-window.md). @@ -151,7 +151,7 @@ supported values are: * On Linux, possible types are `desktop`, `dock`, `toolbar`, `splash`, `notification`. -* On OS X, possible types are `desktop`, `textured`. +* On macOS, possible types are `desktop`, `textured`. * The `textured` type adds metal gradient appearance (`NSTexturedBackgroundWindowMask`). * The `desktop` type places the window at the desktop background window level @@ -159,7 +159,7 @@ supported values are: focus, keyboard or mouse events, but you can use `globalShortcut` to receive input sparingly. -The `titleBarStyle` option is only supported on OS X 10.10 Yosemite and newer. +The `titleBarStyle` option is only supported on macOS 10.10 Yosemite and newer. Possible values are: * `default` or not specified, results in the standard gray opaque Mac title @@ -216,7 +216,7 @@ The `webPreferences` option is an object that can have following properties: * `directWrite` Boolean - Enables DirectWrite font rendering system on Windows. Default is `true`. * `scrollBounce` Boolean - Enables scroll bounce (rubber banding) effect on - OS X. Default is `false`. + macOS. Default is `false`. * `blinkFeatures` String - A list of feature strings separated by `,`, like `CSSVariables,KeyboardEventKey` to enable. The full list of supported feature strings can be found in the [RuntimeEnabledFeatures.in][blink-feature-string] @@ -338,9 +338,9 @@ Emitted when the window is getting resized. Emitted when the window is getting moved to a new position. -__Note__: On OS X this event is just an alias of `moved`. +__Note__: On macOS this event is just an alias of `moved`. -### Event: 'moved' _OS X_ +### Event: 'moved' _macOS_ Emitted once when the window is moved to a new position. @@ -384,15 +384,15 @@ someWindow.on('app-command', (e, cmd) => { }); ``` -### Event: 'scroll-touch-begin' _OS X_ +### Event: 'scroll-touch-begin' _macOS_ Emitted when scroll wheel event phase has begun. -### Event: 'scroll-touch-end' _OS X_ +### Event: 'scroll-touch-end' _macOS_ Emitted when scroll wheel event phase has ended. -### Event: 'swipe' _OS X_ +### Event: 'swipe' _macOS_ Returns: @@ -567,7 +567,7 @@ Sets whether the window should be in fullscreen mode. Returns a boolean, whether the window is in fullscreen mode. -### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_ +### `win.setAspectRatio(aspectRatio[, extraSize])` _macOS_ * `aspectRatio` The aspect ratio we want to maintain for some portion of the content view. @@ -597,7 +597,7 @@ height areas you have within the overall content view. * `y` Integer * `width` Integer * `height` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ Resizes and moves the window to `width`, `height`, `x`, `y`. @@ -609,7 +609,7 @@ Returns an object that contains window's width, height, x and y values. * `width` Integer * `height` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ Resizes the window to `width` and `height`. @@ -621,7 +621,7 @@ Returns an array that contains window's width and height. * `width` Integer * `height` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ Resizes the window's client area (e.g. the web page) to `width` and `height`. @@ -661,37 +661,37 @@ Sets whether the window can be manually resized by user. Returns whether the window can be manually resized by user. -### `win.setMovable(movable)` _OS X_ _Windows_ +### `win.setMovable(movable)` _macOS_ _Windows_ * `movable` Boolean Sets whether the window can be moved by user. On Linux does nothing. -### `win.isMovable()` _OS X_ _Windows_ +### `win.isMovable()` _macOS_ _Windows_ Returns whether the window can be moved by user. On Linux always returns `true`. -### `win.setMinimizable(minimizable)` _OS X_ _Windows_ +### `win.setMinimizable(minimizable)` _macOS_ _Windows_ * `minimizable` Boolean Sets whether the window can be manually minimized by user. On Linux does nothing. -### `win.isMinimizable()` _OS X_ _Windows_ +### `win.isMinimizable()` _macOS_ _Windows_ Returns whether the window can be manually minimized by user. On Linux always returns `true`. -### `win.setMaximizable(maximizable)` _OS X_ _Windows_ +### `win.setMaximizable(maximizable)` _macOS_ _Windows_ * `maximizable` Boolean Sets whether the window can be manually maximized by user. On Linux does nothing. -### `win.isMaximizable()` _OS X_ _Windows_ +### `win.isMaximizable()` _macOS_ _Windows_ Returns whether the window can be manually maximized by user. On Linux always returns `true`. @@ -708,13 +708,13 @@ maximizes the window. Returns whether the maximize/zoom window button toggles fullscreen mode or maximizes the window. -### `win.setClosable(closable)` _OS X_ _Windows_ +### `win.setClosable(closable)` _macOS_ _Windows_ * `closable` Boolean Sets whether the window can be manually closed by user. On Linux does nothing. -### `win.isClosable()` _OS X_ _Windows_ +### `win.isClosable()` _macOS_ _Windows_ Returns whether the window can be manually closed by user. On Linux always returns `true`. @@ -739,7 +739,7 @@ Moves window to the center of the screen. * `x` Integer * `y` Integer -* `animate` Boolean (optional) _OS X_ +* `animate` Boolean (optional) _macOS_ Moves window to `x` and `y`. @@ -760,9 +760,9 @@ Returns the title of the native window. **Note:** The title of web page can be different from the title of the native window. -### `win.setSheetOffset(offsetY[, offsetX])` _OS X_ +### `win.setSheetOffset(offsetY[, offsetX])` _macOS_ -Changes the attachment point for sheets on Mac OS X. By default, sheets are +Changes the attachment point for sheets on macOS. By default, sheets are attached just below the window frame, but you may want to display them beneath a HTML-rendered toolbar. For example: @@ -797,7 +797,7 @@ Returns whether the window is in kiosk mode. Returns the platform-specific handle of the window as `Buffer`. -The native type of the handle is `HWND` on Windows, `NSView*` on OS X, and +The native type of the handle is `HWND` on Windows, `NSView*` on macOS, and `Window` (`unsigned long`) on Linux. ### `win.hookWindowMessage(message, callback)` _Windows_ @@ -824,25 +824,25 @@ Unhook the window message. Unhooks all of the window messages. -### `win.setRepresentedFilename(filename)` _OS X_ +### `win.setRepresentedFilename(filename)` _macOS_ * `filename` String Sets the pathname of the file the window represents, and the icon of the file will show in window's title bar. -### `win.getRepresentedFilename()` _OS X_ +### `win.getRepresentedFilename()` _macOS_ Returns the pathname of the file the window represents. -### `win.setDocumentEdited(edited)` _OS X_ +### `win.setDocumentEdited(edited)` _macOS_ * `edited` Boolean Specifies whether the window’s document has been edited, and the icon in title bar will become gray when set to `true`. -### `win.isDocumentEdited()` _OS X_ +### `win.isDocumentEdited()` _macOS_ Whether the window's document has been edited. @@ -903,14 +903,14 @@ screen readers Sets a 16 x 16 pixel overlay onto the current taskbar icon, usually used to convey some sort of application status or to passively notify the user. -### `win.setHasShadow(hasShadow)` _OS X_ +### `win.setHasShadow(hasShadow)` _macOS_ * `hasShadow` (Boolean) Sets whether the window should have a shadow. On Windows and Linux does nothing. -### `win.hasShadow()` _OS X_ +### `win.hasShadow()` _macOS_ Returns whether the window has a shadow. On Windows and Linux always returns `true`. @@ -951,7 +951,7 @@ The `flags` is an array that can include following `String`s: button state is drawn. This value is intended for instances where the button is used in a notification. -### `win.showDefinitionForSelection()` _OS X_ +### `win.showDefinitionForSelection()` _macOS_ Same as `webContents.showDefinitionForSelection()`. diff --git a/docs/api/crash-reporter.md b/docs/api/crash-reporter.md index 1a07ac31d41..bd323de8839 100644 --- a/docs/api/crash-reporter.md +++ b/docs/api/crash-reporter.md @@ -42,7 +42,7 @@ The `crash-reporter` module has the following methods: You are required to call this method before using other `crashReporter` APIs. -**Note:** On OS X, Electron uses a new `crashpad` client, which is different +**Note:** On macOS, Electron uses a new `crashpad` client, which is different from `breakpad` on Windows and Linux. To enable the crash collection feature, you are required to call the `crashReporter.start` API to initialize `crashpad` in the main process and in each renderer process from which you wish to collect diff --git a/docs/api/dialog.md b/docs/api/dialog.md index c276f2e2d5b..afc32afda46 100644 --- a/docs/api/dialog.md +++ b/docs/api/dialog.md @@ -103,7 +103,7 @@ will be passed via `callback(filename)` * `cancelId` Integer - The value will be returned when user cancels the dialog instead of clicking the buttons of the dialog. By default it is the index of the buttons that have "cancel" or "no" as label, or 0 if there is no such - buttons. On OS X and Windows the index of "Cancel" button will always be + buttons. On macOS and Windows the index of "Cancel" button will always be used as `cancelId`, not matter whether it is already specified. * `noLink` Boolean - On Windows Electron will try to figure out which one of the `buttons` are common buttons (like "Cancel" or "Yes"), and show the @@ -129,7 +129,7 @@ and no GUI dialog will appear. ## Sheets -On Mac OS X, dialogs are presented as sheets attached to a window if you provide +On macOS, dialogs are presented as sheets attached to a window if you provide a `BrowserWindow` reference in the `browserWindow` parameter, or modals if no window is provided. diff --git a/docs/api/frameless-window.md b/docs/api/frameless-window.md index 5e365fa677f..b6b5926beef 100644 --- a/docs/api/frameless-window.md +++ b/docs/api/frameless-window.md @@ -18,9 +18,9 @@ const {BrowserWindow} = require('electron') let win = new BrowserWindow({width: 800, height: 600, frame: false}) ``` -### Alternatives on OS X +### Alternatives on macOS -On Mac OS X 10.10 Yosemite and newer, there's an alternative way to specify +On macOS 10.10 Yosemite and newer, there's an alternative way to specify a chromeless window. Instead of setting `frame` to `false` which disables both the titlebar and window controls, you may want to have the title bar hidden and your content extend to the full window size, yet still preserve diff --git a/docs/api/menu-item.md b/docs/api/menu-item.md index e53e98e0e34..ec3fef55e57 100644 --- a/docs/api/menu-item.md +++ b/docs/api/menu-item.md @@ -52,7 +52,7 @@ The `role` property can have following values: * `minimize` - Minimize current window * `close` - Close current window -On OS X `role` can also have following additional values: +On macOS `role` can also have following additional values: * `about` - Map to the `orderFrontStandardAboutPanel` action * `hide` - Map to the `hide` action @@ -64,7 +64,7 @@ On OS X `role` can also have following additional values: * `help` - The submenu is a "Help" menu * `services` - The submenu is a "Services" menu -When specifying `role` on OS X, `label` and `accelerator` are the only options +When specifying `role` on macOS, `label` and `accelerator` are the only options that will affect the MenuItem. All other options will be ignored. ## Instance Properties diff --git a/docs/api/menu.md b/docs/api/menu.md index 7fe450bcf9c..7dea2c6b4cd 100644 --- a/docs/api/menu.md +++ b/docs/api/menu.md @@ -226,7 +226,7 @@ The `menu` class has the following methods: * `menu` Menu -Sets `menu` as the application menu on OS X. On Windows and Linux, the `menu` +Sets `menu` as the application menu on macOS. On Windows and Linux, the `menu` will be set as each window's top menu. **Note:** This API has to be called after the `ready` event of `app` module. @@ -235,7 +235,7 @@ will be set as each window's top menu. Returns the application menu (an instance of `Menu`), if set, or `null`, if not set. -### `Menu.sendActionToFirstResponder(action)` _OS X_ +### `Menu.sendActionToFirstResponder(action)` _macOS_ * `action` String @@ -243,8 +243,8 @@ Sends the `action` to the first responder of application. This is used for emulating default Cocoa menu behaviors, usually you would just use the `role` property of `MenuItem`. -See the [OS X Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7) -for more information on OS X's native actions. +See the [macOS Cocoa Event Handling Guide](https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/EventOverview/EventArchitecture/EventArchitecture.html#//apple_ref/doc/uid/10000060i-CH3-SW7) +for more information on macOS' native actions. ### `Menu.buildFromTemplate(template)` @@ -265,7 +265,7 @@ The `menu` object has the following instance methods: * `browserWindow` BrowserWindow (optional) - Default is `null`. * `x` Number (optional) - Default is -1. * `y` Number (**required** if `x` is used) - Default is -1. -* `positioningItem` Number (optional) _OS X_ - The index of the menu item to +* `positioningItem` Number (optional) _macOS_ - The index of the menu item to be positioned under the mouse cursor at the specified coordinates. Default is -1. @@ -294,14 +294,14 @@ Inserts the `menuItem` to the `pos` position of the menu. Get an array containing the menu's items. -## Notes on OS X Application Menu +## Notes on macOS Application Menu -OS X has a completely different style of application menu from Windows and +macOS has a completely different style of application menu from Windows and Linux, here are some notes on making your app's menu more native-like. ### Standard Menus -On OS X there are many system defined standard menus, like the `Services` and +On macOS there are many system defined standard menus, like the `Services` and `Windows` menus. To make your menu a standard menu, you should set your menu's `role` to one of following and Electron will recognize them and make them become standard menus: @@ -312,13 +312,13 @@ become standard menus: ### Standard Menu Item Actions -OS X has provided standard actions for some menu items, like `About xxx`, +macOS has provided standard actions for some menu items, like `About xxx`, `Hide xxx`, and `Hide Others`. To set the action of a menu item to a standard action, you should set the `role` attribute of the menu item. ### Main Menu's Name -On OS X the label of application menu's first item is always your app's name, +On macOS the label of application menu's first item is always your app's name, no matter what label you set. To change it you have to change your app's name by modifying your app bundle's `Info.plist` file. See [About Information Property List Files][AboutInformationPropertyListFiles] for more information. diff --git a/docs/api/native-image.md b/docs/api/native-image.md index d61f57ee4b9..d2a2926ca6d 100644 --- a/docs/api/native-image.md +++ b/docs/api/native-image.md @@ -81,7 +81,7 @@ mixed with other content to create the desired final appearance. The most common case is to use template images for a menu bar icon so it can adapt to both light and dark menu bars. -**Note:** Template image is only supported on OS X. +**Note:** Template image is only supported on macOS. To mark an image as a template image, its filename should end with the word `Template`. For example: @@ -141,10 +141,10 @@ Returns a [Buffer][buffer] that contains the image's `JPEG` encoded data. Returns the data URL of the image. -### `image.getNativeHandle()` _OS X_ +### `image.getNativeHandle()` _macOS_ Returns a [Buffer][buffer] that stores C pointer to underlying native handle of -the image. On OS X, a pointer to `NSImage` instance would be returned. +the image. On macOS, a pointer to `NSImage` instance would be returned. Notice that the returned pointer is a weak pointer to the underlying native image instead of a copy, so you _must_ ensure that the associated diff --git a/docs/api/process.md b/docs/api/process.md index 37cc81f76a8..3bd8f1a4f27 100644 --- a/docs/api/process.md +++ b/docs/api/process.md @@ -74,7 +74,7 @@ Causes the main thread of the current process crash. Causes the main thread of the current process hang. -### `process.setFdLimit(maxDescriptors)` _OS X_ _Linux_ +### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_ * `maxDescriptors` Integer diff --git a/docs/api/shell.md b/docs/api/shell.md index 780e99a0fc1..a1c01f0fbc7 100644 --- a/docs/api/shell.md +++ b/docs/api/shell.md @@ -31,7 +31,7 @@ Open the given file in the desktop's default manner. ### `shell.openExternal(url[, options])` * `url` String -* `options` Object (optional) _OS X_ +* `options` Object (optional) _macOS_ * `activate` Boolean - `true` to bring the opened application to the foreground. The default is `true`. diff --git a/docs/api/system-preferences.md b/docs/api/system-preferences.md index 7b2f0724a4a..a2cdeb6c4f5 100644 --- a/docs/api/system-preferences.md +++ b/docs/api/system-preferences.md @@ -4,16 +4,16 @@ ## Methods -### `systemPreferences.isDarkMode()` _OS X_ +### `systemPreferences.isDarkMode()` _macOS_ This method returns `true` if the system is in Dark Mode, and `false` otherwise. -### `systemPreferences.subscribeNotification(event, callback)` _OS X_ +### `systemPreferences.subscribeNotification(event, callback)` _macOS_ * `event` String * `callback` Function -Subscribes to native notifications of OS X, `callback` will be called with +Subscribes to native notifications of macOS, `callback` will be called with `callback(event, userInfo)` when the corresponding `event` happens. The `userInfo` is an Object that contains the user information dictionary sent along with the notification. @@ -29,13 +29,13 @@ example values of `event` are: * `AppleColorPreferencesChangedNotification` * `AppleShowScrollBarsSettingChanged` -### `systemPreferences.unsubscribeNotification(id)` _OS X_ +### `systemPreferences.unsubscribeNotification(id)` _macOS_ * `id` Integer Removes the subscriber with `id`. -### `systemPreferences.getUserDefault(key, type)` _OS X_ +### `systemPreferences.getUserDefault(key, type)` _macOS_ * `key` String * `type` String - Can be `string`, `boolean`, `integer`, `float`, `double`, @@ -43,7 +43,7 @@ Removes the subscriber with `id`. Get the value of `key` in system preferences. -This API reads from `NSUserDefaults` on OS X, some popular `key` and `type`s +This API reads from `NSUserDefaults` on macOS, some popular `key` and `type`s are: * `AppleInterfaceStyle: string` diff --git a/docs/api/tray.md b/docs/api/tray.md index 2b2bffd15ab..902444e5336 100644 --- a/docs/api/tray.md +++ b/docs/api/tray.md @@ -71,9 +71,9 @@ labeled as such. Emitted when the tray icon is clicked. -**Note:** The `bounds` payload is only implemented on OS X and Windows. +**Note:** The `bounds` payload is only implemented on macOS and Windows. -### Event: 'right-click' _OS X_ _Windows_ +### Event: 'right-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -88,7 +88,7 @@ Emitted when the tray icon is clicked. Emitted when the tray icon is right clicked. -### Event: 'double-click' _OS X_ _Windows_ +### Event: 'double-click' _macOS_ _Windows_ * `event` Event * `altKey` Boolean @@ -116,26 +116,26 @@ Emitted when the tray balloon is clicked. Emitted when the tray balloon is closed because of timeout or user manually closes it. -### Event: 'drop' _OS X_ +### Event: 'drop' _macOS_ Emitted when any dragged items are dropped on the tray icon. -### Event: 'drop-files' _OS X_ +### Event: 'drop-files' _macOS_ * `event` * `files` Array - the file path of dropped files. Emitted when dragged files are dropped in the tray icon. -### Event: 'drag-enter' _OS X_ +### Event: 'drag-enter' _macOS_ Emitted when a drag operation enters the tray icon. -### Event: 'drag-leave' _OS X_ +### Event: 'drag-leave' _macOS_ Emitted when a drag operation exits the tray icon. -### Event: 'drag-end' _OS X_ +### Event: 'drag-end' _macOS_ Emitted when a drag operation ends on the tray or ends at another location. @@ -156,11 +156,11 @@ Destroys the tray icon immediately. Sets the `image` associated with this tray icon. -### `Tray.setPressedImage(image)` _OS X_ +### `Tray.setPressedImage(image)` _macOS_ * `image` [NativeImage](native-image.md) -Sets the `image` associated with this tray icon when pressed on OS X. +Sets the `image` associated with this tray icon when pressed on macOS. ### `Tray.setToolTip(toolTip)` @@ -168,13 +168,13 @@ Sets the `image` associated with this tray icon when pressed on OS X. Sets the hover text for this tray icon. -### `Tray.setTitle(title)` _OS X_ +### `Tray.setTitle(title)` _macOS_ * `title` String Sets the title displayed aside of the tray icon in the status bar. -### `Tray.setHighlightMode(highlight)` _OS X_ +### `Tray.setHighlightMode(highlight)` _macOS_ * `highlight` Boolean @@ -190,7 +190,7 @@ when the tray icon is clicked. Defaults to true. Displays a tray balloon. -### `Tray.popUpContextMenu([menu, position])` _OS X_ _Windows_ +### `Tray.popUpContextMenu([menu, position])` _macOS_ _Windows_ * `menu` Menu (optional) * `position` Object (optional) - The pop up position. diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md index 19a7ba07556..fec4708d1c6 100644 --- a/docs/api/web-contents.md +++ b/docs/api/web-contents.md @@ -957,7 +957,7 @@ win.webContents.on('did-finish-load', () => { }); ``` -### `webContents.showDefinitionForSelection()` _OS X_ +### `webContents.showDefinitionForSelection()` _macOS_ Shows pop-up dictionary that searches the selected word on the page. diff --git a/docs/api/web-view-tag.md b/docs/api/web-view-tag.md index c210bd8b9cb..25725cecea2 100644 --- a/docs/api/web-view-tag.md +++ b/docs/api/web-view-tag.md @@ -490,7 +490,7 @@ Sends an input `event` to the page. See [webContents.sendInputEvent](web-contents.md##webcontentssendinputeventevent) for detailed description of `event` object. -### `.showDefinitionForSelection()` _OS X_ +### `.showDefinitionForSelection()` _macOS_ Shows pop-up dictionary that searches the selected word on the page. diff --git a/docs/development/build-instructions-osx.md b/docs/development/build-instructions-osx.md index b703a75897d..13ac616603f 100644 --- a/docs/development/build-instructions-osx.md +++ b/docs/development/build-instructions-osx.md @@ -1,10 +1,10 @@ -# Build Instructions (OS X) +# Build Instructions (macOS) -Follow the guidelines below for building Electron on OS X. +Follow the guidelines below for building Electron on macOS. ## Prerequisites -* OS X >= 10.8 +* macOS >= 10.8 * [Xcode](https://developer.apple.com/technologies/tools/) >= 5.1 * [node.js](http://nodejs.org) (external) @@ -48,8 +48,8 @@ After building is done, you can find `Electron.app` under `out/D`. ## 32bit Support -Electron can only be built for a 64bit target on OS X and there is no plan to -support 32bit OS X in future. +Electron can only be built for a 64bit target on macOS and there is no plan to +support 32bit macOS in future. ## Tests diff --git a/docs/styleguide.md b/docs/styleguide.md index a34889d2ca3..44afe2aadb8 100644 --- a/docs/styleguide.md +++ b/docs/styleguide.md @@ -24,7 +24,7 @@ These are the ways that we construct the Electron documentation. - Optional arguments are denoted when called out in list. - Line length is 80-column wrapped. - Platform specific methods are noted in italics following method header. - - ```### `method(foo, bar)` _OS X_``` + - ```### `method(foo, bar)` _macOS_``` - Prefer 'in the ___ process' over 'on' ### Documentation Translations diff --git a/docs/tutorial/application-distribution.md b/docs/tutorial/application-distribution.md index 4d3e12db75f..7eeea8dcd14 100644 --- a/docs/tutorial/application-distribution.md +++ b/docs/tutorial/application-distribution.md @@ -1,11 +1,11 @@ # Application Distribution To distribute your app with Electron, the folder containing your app should be -named `app` and placed under Electron's resources directory (on OS X it is +named `app` and placed under Electron's resources directory (on macOS it is `Electron.app/Contents/Resources/` and on Linux and Windows it is `resources/`), like this: -On OS X: +On macOS: ```text electron/Electron.app/Contents/Resources/app/ @@ -37,7 +37,7 @@ To use an `asar` archive to replace the `app` folder, you need to rename the archive to `app.asar`, and put it under Electron's resources directory like below, and Electron will then try to read the archive and start from it. -On OS X: +On macOS: ```text electron/Electron.app/Contents/Resources/ @@ -63,7 +63,7 @@ before distributing it to users. You can rename `electron.exe` to any name you like, and edit its icon and other information with tools like [rcedit](https://github.com/atom/rcedit). -### OS X +### macOS You can rename `Electron.app` to any name you want, and you also have to rename the `CFBundleDisplayName`, `CFBundleIdentifier` and `CFBundleName` fields in diff --git a/docs/tutorial/desktop-environment-integration.md b/docs/tutorial/desktop-environment-integration.md index 449fb71bc4c..adb08ad5dc4 100644 --- a/docs/tutorial/desktop-environment-integration.md +++ b/docs/tutorial/desktop-environment-integration.md @@ -8,7 +8,7 @@ applications can put a custom menu in the dock menu. This guide explains how to integrate your application into those desktop environments with Electron APIs. -## Notifications (Windows, Linux, OS X) +## Notifications (Windows, Linux, macOS) All three operating systems provide means for applications to send notifications to the user. Electron conveniently allows developers to send notifications with @@ -50,17 +50,17 @@ desktop environment that follows [Desktop Notifications Specification][notification-spec], including Cinnamon, Enlightenment, Unity, GNOME, KDE. -### OS X +### macOS -Notifications are straight-forward on OS X, you should however be aware of +Notifications are straight-forward on macOS, you should however be aware of [Apple's Human Interface guidelines regarding notifications](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/OSXHIGuidelines/NotificationCenter.html). Note that notifications are limited to 256 bytes in size - and will be truncated if you exceed that limit. -## Recent documents (Windows & OS X) +## Recent documents (Windows & macOS) -Windows and OS X provide easy access to a list of recent documents opened by +Windows and macOS provide easy access to a list of recent documents opened by the application via JumpList or dock menu, respectively. __JumpList:__ @@ -95,14 +95,14 @@ on registering your application in [Application Registration][app-registration]. When a user clicks a file from the JumpList, a new instance of your application will be started with the path of the file added as a command line argument. -### OS X Notes +### macOS Notes When a file is requested from the recent documents menu, the `open-file` event of `app` module will be emitted for it. -## Custom Dock Menu (OS X) +## Custom Dock Menu (macOS) -OS X enables developers to specify a custom menu for the dock, which usually +macOS enables developers to specify a custom menu for the dock, which usually contains some shortcuts for commonly used features of your application: __Dock menu of Terminal.app:__ @@ -110,7 +110,7 @@ __Dock menu of Terminal.app:__ To set your custom dock menu, you can use the `app.dock.setMenu` API, which is -only available on OS X: +only available on macOS: ```javascript const electron = require('electron'); @@ -154,7 +154,7 @@ __Tasks of Internet Explorer:__ ![IE](http://i.msdn.microsoft.com/dynimg/IC420539.png) -Unlike the dock menu in OS X which is a real menu, user tasks in Windows work +Unlike the dock menu in macOS which is a real menu, user tasks in Windows work like application shortcuts such that when user clicks a task, a program will be executed with specified arguments. @@ -248,13 +248,13 @@ __Launcher shortcuts of Audacious:__ ![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png) -## Progress Bar in Taskbar (Windows, OS X, Unity) +## Progress Bar in Taskbar (Windows, macOS, Unity) On Windows a taskbar button can be used to display a progress bar. This enables a window to provide progress information to the user without the user having to switch to the window itself. -On OS X the progress bar will be displayed as a part of the dock icon. +On macOS the progress bar will be displayed as a part of the dock icon. The Unity DE also has a similar feature that allows you to specify the progress bar in the launcher. @@ -298,9 +298,9 @@ let win = new BrowserWindow({...}); win.setOverlayIcon('path/to/overlay.png', 'Description for overlay'); ``` -## Represented File of Window (OS X) +## Represented File of Window (macOS) -On OS X a window can set its represented file, so the file's icon can show in +On macOS a window can set its represented file, so the file's icon can show in the title bar and when users Command-Click or Control-Click on the title a path popup will show. diff --git a/docs/tutorial/devtools-extension.md b/docs/tutorial/devtools-extension.md index 94f5ac13bf6..de58d671f77 100644 --- a/docs/tutorial/devtools-extension.md +++ b/docs/tutorial/devtools-extension.md @@ -21,7 +21,7 @@ Using the [React Developer Tools][react-devtools] as example: * `~/.config/google-chrome-beta/Default/Extensions/` * `~/.config/google-chrome-canary/Default/Extensions/` * `~/.config/chromium/Default/Extensions/` - * on OS X it is `~/Library/Application Support/Google/Chrome/Default/Extensions`. + * on macOS it is `~/Library/Application Support/Google/Chrome/Default/Extensions`. 1. Pass the location of the extension to `BrowserWindow.addDevToolsExtension` API, for the React Developer Tools, it is something like: `~/Library/Application Support/Google/Chrome/Default/Extensions/fmkadmapgofadopljbjfkapdkoienihi/0.14.10_0` diff --git a/docs/tutorial/mac-app-store-submission-guide.md b/docs/tutorial/mac-app-store-submission-guide.md index 80a2f8acc9f..c7ed9162fdc 100644 --- a/docs/tutorial/mac-app-store-submission-guide.md +++ b/docs/tutorial/mac-app-store-submission-guide.md @@ -116,7 +116,7 @@ codesign -s "$APP_KEY" -f --entitlements "$PARENT_PLIST" "$APP_PATH" productbuild --component "$APP_PATH" /Applications --sign "$INSTALLER_KEY" "$RESULT_PATH" ``` -If you are new to app sandboxing under OS X, you should also read through +If you are new to app sandboxing under macOS, you should also read through Apple's [Enabling App Sandbox][enable-app-sandbox] to have a basic idea, then add keys for the permissions needed by your app to the entitlements files. diff --git a/docs/tutorial/quick-start.md b/docs/tutorial/quick-start.md index 59ee27602b3..59bfb4bb26b 100644 --- a/docs/tutorial/quick-start.md +++ b/docs/tutorial/quick-start.md @@ -116,7 +116,7 @@ app.on('ready', createWindow); // Quit when all windows are closed. app.on('window-all-closed', () => { - // On OS X it is common for applications and their menu bar + // On macOS it is common for applications and their menu bar // to stay active until the user quits explicitly with Cmd + Q if (process.platform !== 'darwin') { app.quit(); @@ -124,7 +124,7 @@ app.on('window-all-closed', () => { }); app.on('activate', () => { - // On OS X it's common to re-create a window in the app when the + // On macOS it's common to re-create a window in the app when the // dock icon is clicked and there are no other windows open. if (win === null) { createWindow(); @@ -194,7 +194,7 @@ $ .\electron\electron.exe your-app\ $ ./electron/electron your-app/ ``` -#### OS X +#### macOS ```bash $ ./Electron.app/Contents/MacOS/Electron your-app/ diff --git a/docs/tutorial/supported-platforms.md b/docs/tutorial/supported-platforms.md index a7f736995d2..322ee422268 100644 --- a/docs/tutorial/supported-platforms.md +++ b/docs/tutorial/supported-platforms.md @@ -2,10 +2,10 @@ Following platforms are supported by Electron: -### OS X +### macOS -Only 64bit binaries are provided for OS X, and the minimum OS X version -supported is OS X 10.9. +Only 64bit binaries are provided for macOS, and the minimum macOS version +supported is macOS 10.9. ### Windows diff --git a/docs/tutorial/testing-on-headless-ci.md b/docs/tutorial/testing-on-headless-ci.md index 343d2d242cc..557c358b12b 100644 --- a/docs/tutorial/testing-on-headless-ci.md +++ b/docs/tutorial/testing-on-headless-ci.md @@ -20,11 +20,11 @@ for `$DISPLAY`, so no further configuration of your app is required. This step can be automated with Paul Betts's [xvfb-maybe](https://github.com/paulcbetts/xvfb-maybe): Prepend your test commands with `xvfb-maybe` and the little tool will automatically configure -xvfb, if required by the current system. On Windows or Mac OS X, it will simply +xvfb, if required by the current system. On Windows or macOS, it will simply do nothing. ``` -## On Windows or OS X, this just invokes electron-mocha +## On Windows or macOS, this just invokes electron-mocha ## On Linux, if we are in a headless environment, this will be equivalent ## to xvfb-run electron-mocha ./test/*.js xvfb-maybe electron-mocha ./test/*.js diff --git a/docs/tutorial/using-pepper-flash-plugin.md b/docs/tutorial/using-pepper-flash-plugin.md index 747543f3f86..349d7c0e9f6 100644 --- a/docs/tutorial/using-pepper-flash-plugin.md +++ b/docs/tutorial/using-pepper-flash-plugin.md @@ -6,7 +6,7 @@ and then enable it in your application. ## Prepare a Copy of Flash Plugin -On OS X and Linux, the details of the Pepper Flash plugin can be found by +On macOS and Linux, the details of the Pepper Flash plugin can be found by navigating to `chrome://plugins` in the Chrome browser. Its location and version are useful for Electron's Pepper Flash support. You can also copy it to another location. diff --git a/docs/tutorial/using-widevine-cdm-plugin.md b/docs/tutorial/using-widevine-cdm-plugin.md index af1337c5eae..b7b37c58a99 100644 --- a/docs/tutorial/using-widevine-cdm-plugin.md +++ b/docs/tutorial/using-widevine-cdm-plugin.md @@ -12,7 +12,7 @@ the architecture and Chrome version of the Electron build you use. version used by Electron, otherwise the plugin will not work even though `navigator.plugins` would show it has been loaded. -### Windows & OS X +### Windows & macOS Open `chrome://components/` in Chrome browser, find `WidevineCdm` and make sure it is up to date, then you can find all the plugin binaries from the @@ -20,12 +20,12 @@ sure it is up to date, then you can find all the plugin binaries from the directory. `APP_DATA` is system's location for storing app data, on Windows it is -`%LOCALAPPDATA%`, on OS X it is `~/Library/Application Support`. `VERSION` is +`%LOCALAPPDATA%`, on macOS it is `~/Library/Application Support`. `VERSION` is Widevine CDM plugin's version string, like `1.4.8.866`. `PLATFORM` is `mac` or `win`. `ARCH` is `x86` or `x64`. On Windows the required binaries are `widevinecdm.dll` and -`widevinecdmadapter.dll`, on OS X they are `libwidevinecdm.dylib` and +`widevinecdmadapter.dll`, on macOS they are `libwidevinecdm.dylib` and `widevinecdmadapter.plugin`. You can copy them to anywhere you like, but they have to be put together. @@ -52,7 +52,7 @@ Example code: ```javascript // You have to pass the filename of `widevinecdmadapter` here, it is -// * `widevinecdmadapter.plugin` on OS X, +// * `widevinecdmadapter.plugin` on macOS, // * `libwidevinecdmadapter.so` on Linux, // * `widevinecdmadapter.dll` on Windows. app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin'); diff --git a/lib/browser/api/browser-window.js b/lib/browser/api/browser-window.js index 6ac31e737b8..08476499566 100644 --- a/lib/browser/api/browser-window.js +++ b/lib/browser/api/browser-window.js @@ -10,7 +10,7 @@ BrowserWindow.prototype._init = function () { // Avoid recursive require. const {app} = require('electron') - // Simulate the application menu on platforms other than OS X. + // Simulate the application menu on platforms other than macOS. if (process.platform !== 'darwin') { const menu = app.getApplicationMenu() if (menu) this.setMenu(menu) @@ -55,7 +55,7 @@ BrowserWindow.prototype._init = function () { // focus it when we first start to load URL, if we do it earlier it won't // have effect, if we do it later we might move focus in the page. // - // Though this hack is only needed on OS X when the app is launched from + // Though this hack is only needed on macOS when the app is launched from // Finder, we still do it on all platforms in case of other bugs we don't // know. this.webContents.once('load-url', function () { diff --git a/spec/api-auto-updater-spec.js b/spec/api-auto-updater-spec.js index 6335f335943..f3c897865b8 100644 --- a/spec/api-auto-updater-spec.js +++ b/spec/api-auto-updater-spec.js @@ -21,7 +21,7 @@ if (!process.mas) { }) describe('setFeedURL', function () { - it('emits an error on Mac OS X when the application is unsigned', function (done) { + it('emits an error on macOS when the application is unsigned', function (done) { if (process.platform !== 'darwin') { return done() } diff --git a/spec/api-browser-window-spec.js b/spec/api-browser-window-spec.js index c5735b75a8a..598a3470f75 100644 --- a/spec/api-browser-window-spec.js +++ b/spec/api-browser-window-spec.js @@ -780,7 +780,7 @@ describe('browser-window module', function () { }) describe('fullscreenable state', function () { - // Only implemented on OS X. + // Only implemented on macOS. if (process.platform !== 'darwin') return it('can be changed with fullscreenable option', function () { diff --git a/spec/api-native-image-spec.js b/spec/api-native-image-spec.js index 196ed1356d7..4ada22af9ed 100644 --- a/spec/api-native-image-spec.js +++ b/spec/api-native-image-spec.js @@ -35,7 +35,7 @@ describe('nativeImage module', () => { assert.equal(image.getSize().width, 538) }) - it('Gets an NSImage pointer on OS X', () => { + it('Gets an NSImage pointer on macOS', () => { if (process.platform !== 'darwin') return const imagePath = `${path.join(__dirname, 'fixtures', 'api')}${path.sep}..${path.sep}${path.join('assets', 'logo.png')}` diff --git a/toolchain.gypi b/toolchain.gypi index 11da28f7023..1c5f8a71351 100644 --- a/toolchain.gypi +++ b/toolchain.gypi @@ -6,7 +6,7 @@ 'clang%': 1, 'variables': { - # The minimum OS X SDK version to use. + # The minimum macOS SDK version to use. 'mac_sdk_min%': '10.10', # Set ARM architecture version.