This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
action:Write_to_a_File [2016/03/13 09:29] AlainLifchitz add internal links |
action:Write_to_a_File [2018/02/19 01:35] peternlewis Write to a File v8.1 |
||
---|---|---|---|
Line 1: | Line 1: | ||
The Write to a File and [[action:Append Text to a File|Append Text to a File]] actions allow you to write a variety of things to a file on disk. | The Write to a File and [[action:Append Text to a File|Append Text to a File]] actions allow you to write a variety of things to a file on disk. | ||
+ | |||
+ | **Warning: Ensure you specify a file path, not a path to a directory - this action uses an Apple API that can overwrite directories, destroying them completely (pre-v8.1).** As of v8.1+, this action will trash (if possible) (in to the trash folder) any existing file or directory you are about to overwrite. | ||
Write or append the current system clipboard, a named clipboard, a variable, some text or some styled text (you can write but cannot append styled text). | Write or append the current system clipboard, a named clipboard, a variable, some text or some styled text (you can write but cannot append styled text). | ||
Line 7: | Line 9: | ||
You can write the file in a variety of formats, including plain text, RTF or RTFD, SimpleText, as an HTML folder or web archive, or a Word Doc, Word XML, Open Office XML, or Open Document. You can only append to plain text formats though. | You can write the file in a variety of formats, including plain text, RTF or RTFD, SimpleText, as an HTML folder or web archive, or a Word Doc, Word XML, Open Office XML, or Open Document. You can only append to plain text formats though. | ||
- | Clipboards which contain images can be written in various formats: PNG, TIFF, JPEG, BMP, GIF. Plain text formats can have a specified character encoding: MacRoman, ISO-8859 Latin 1, UTF-8, UTF-16. | + | [[:Clipboards|Clipboards]] which contain images can be written in various formats: PNG, TIFF, JPEG, BMP, GIF. Plain text formats can have a specified character encoding: MacRoman, ISO-8859 Latin 1, UTF-8, UTF-16. |
If you change the format or extension of the file in the ‘//to file//’ field, the ‘//with format//’ selector changes to match. If you hold the Option key down and change the format selector, the extension in the ‘//to file//’ field will be left unchanged (7.0+). | If you change the format or extension of the file in the ‘//to file//’ field, the ‘//with format//’ selector changes to match. If you hold the Option key down and change the format selector, the extension in the ‘//to file//’ field will be left unchanged (7.0+). | ||
Note the difference between the Write and Append actions: Write changes the entire contents of the file on disk while Append adds the new content at the end of the file. | Note the difference between the Write and Append actions: Write changes the entire contents of the file on disk while Append adds the new content at the end of the file. | ||
+ | |||
+ | For text, the action allows you to control what text processing happens in the gear menu (7.2+) : | ||
+ | |||
+ | * Process Text Normally (process text tokens and backslash characters) | ||
+ | * Process Text Tokens Only (process text tokens but not backslash characters) | ||
+ | * Process Nothing (process neither text tokens nor backslash characters) | ||
+ | |||
+ | Most other [Text Fields](https://wiki.keyboardmaestro.com/Text_Fields) in Keyboard Maestro process both text tokens and (except for regular expression fields) backslash characters. | ||
===== See Also ===== | ===== See Also ===== | ||
Line 21: | Line 31: | ||
* [[action:Delete a File|Delete a File]] | * [[action:Delete a File|Delete a File]] | ||
* [[action:Read a File|Read a File]] | * [[action:Read a File|Read a File]] | ||
+ | * [[action:Set Variable to Text|Set Variable to Text]] | ||
* [[:Actions|See all Actions]] | * [[:Actions|See all Actions]] | ||
+ | |||
+ | ==== Topics ==== | ||
+ | |||
+ | * [[:Clipboards|Clipboards]] | ||
+ | * [[:Frequently Asked Questions|FAQ]] | ||
---- | ---- | ||
Line 27: | Line 43: | ||
==== Forum ==== | ==== Forum ==== | ||
- | - [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+Write+to+File|Keyboard Maestro Forum topics about Write to a File action]] | + | - [[https://forum.keyboardmaestro.com/t/can-i-trigger-a-macro-if-an-image-made-by-screenshot-utility-was-added-to-clipboard/3612/2|Can I trigger a macro if an image made by screenshot utility was added to clipboard?]] |
+ | |||
+ | - [[https://forum.keyboardmaestro.com/search?q=Write%20File|Keyboard Maestro Forum topics about Write to a File action]] |