Differences

This shows you the differences between two versions of the page.

--- Forum [2016/03/04 16:57]
JMichaelTX ADD instruction on how to move Macro upload to existing topic
+++ Forum [2021/02/03 18:32]
JMichaelTX [1. Upload Using Share Button]
@@ Line 1: / Line 1: @@
 [[https://forum.keyboardmaestro.com|{{:forum-icon.jpg |Go To Forum}}]]
-===== Using the Keyboard Maestro Forum =====
+====== Using the Keyboard Maestro Forum ======
-==== How To Get Help ====
+===== Where To Post =====
-If you can't find the answers you need in the Keyboard Maestro Wiki or documentation ([[https://www.keyboardmaestro.com/documentation/7/overview.html|Version 7]]), then the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]  is a great resource to
+  * To get help, post in the [[https://forum.keyboardmaestro.com/c/general|Forum Questions & Suggestions Section]]
+  * To share your completed, working, macro, post in the [[https://forum.keyboardmaestro.com/c/macro|Forum Macro Section]]
+  * **Do not** use the Macro category for posting questions, even about macros. Use the Questions & Suggestions category.
+----
+===== Before Asking =====
+Before you post a question to the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]] please:
+  * Spend a little time looking through the [[/User_Manual|Keyboard Maestro User Manual]].
+  * Use search within the Keyboard Maestro editor Help menu to try to find related actions.
+  * Spend at least 5-10 minutes searching within the forum itself and with Google.
+Even if you don't find what you're looking for you'll improve your knowledge of how to use Keyboard Maestro, and there's a good chance you'll ask better questions on the forum because of it.
+----
+===== How To Get Help =====
+If you can't find the answers you need in the Keyboard Maestro Wiki or ([[/User_Manual|User Manual]]), then the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]  is a great resource to
   * Search for Q&A and Other Macros/Solutions Related to Your Issue
   * Post your questions and issues, and get help from fellow users as well as from the Keyboard Maestro owner himself.
   * Share your completed, working, macro to help others like you.
-=== Searching the Forum for Answers ===
+----
+==== Searching the Forum for Answers ====
 There are two ways to search the Forum:
   - Using the Forum Search Tool by clicking on the magnifying glass (🔍) at the top right of the Forum window
   - Using the Google site search
-    - Just like a normal Google Search, except include the following along with your keywords:\\  `site:forum.keyboardmaestro.com`
+    - Just like a normal Google Search, except include `site:forum.keyboardmaestro.com` along with your keywords:\\  [[https://www.google.com/search?q=site%3Aforum.keyboardmaestro.com%20YourKeywords|site:forum.keyboardmaestro.com YourKeyWords]]
-=== Posting Your Question or Issue to the Forum ===
+----
-If you are having trouble with a macro and want help, then it's best to post both your question/issue AND at least an image of your macro to the Forum.  If it's a complicated macro, then please also attach the macro to your Forum post.  This will help others to understand your issue, and to test the macro if need be.  You can easily share both your macro image and file to the forum.  See below for details.
+==== Posting Your Question or Issue to the Forum ====
-==== Where To Post ====
-  * To get help, post in the [[https://forum.keyboardmaestro.com/c/general|Forum General Section]]
+**Avoid the [[http://xyproblem.info|XY Problem]] of asking about your attempted //solution// rather than your //actual problem//:**
-  * To share your completed, working, macro, post in the [[https://forum.keyboardmaestro.com/c/macro|Forum Macro Section]]
+  * When you are asking a question, ensure you are clear what you are actually trying to accomplish, not just the difficulty you are having in a specific attempt at solving the problem.  There may be a much better way to solve the actual problem rather than resolving the difficulty with your specific attempt.
+  * Always include information about a broader picture along with any attempted solution.
+  * If someone asks for more information, do provide details.
+  * If there are other solutions you have already ruled out, share why you’ve ruled them out. This gives more information about your requirements.
-==== How to Share Images to the Forum ====
+**If you are having trouble with a macro and want help, then please post:**
-You have these choices:
+  * Your question with as much detail as you can
-  - Copy Macro or Action as Image, and paste into Forum topic (except for Safari)
+  * If it involves processing data, provide real world (not madeup) examples of:
-    * Copy the selected macro or action(s) //**as Image**//\\  .
+    * Your source input data
-    * {{:km-copy-as-image.jpg?nolink|}} \\  .
+    * How you want the data to appear after processing by your macro
-    * Paste into the //Forum// Editor.
+  * Upload both your macro image and code (export of macro)
-  - You can drag and drop files directly from the Finder into the //Forum// Editor.
+    * This is now very easy using the Share button in the Keyboard Maestro editor.
+    * See [[Forum#How_to_PostUpload_Your_Macro_to_the_Forum|below for instructions]]
-The Keyboard Maestro Forum Editor supports paste into your post from all major Browsers, except Safari, which only allows drag and drop.
+**For help on using the Forum Editor**, see [[Using Markdown in the Keyboard Maestro Forum]]
-==== How to Share Both Image and Macro to Forum Directly from Keyboard Maestro Editor ====
+This will help others to understand your issue, and to test the macro if need be.\\
+To get the best, fastest answer to your question, provide us with the best info you can.
-The simplest way to share something is to use the Keyboard Maestro Editor's own Share button (see image below).
+----
-This will create a new topic in the forum category you select.
+===== How to Post/Upload Your Macro to the Forum =====
-If you need to share in an existing topic, then AFTER the new topic is created:
+From the Keyboard Maestro editor
+  - For Keyboard Maestro **Version 7+**, use the Share button (see [[Forum#Upload_Using_Share_Button|#1 below]])
+  - For **all versions** of Keyboard Maestro, save to files, then import (see [[Forum#Manual_Upload|#2, Manual Upload, below]])
+----
+==== 1. Upload Using Share Button ====
+(Available for Keyboard Maestro version 7+ only)
+This will create a **new topic** in the forum category you select.
+    - Click on the Macro name in the Editor
+    - Click on the Share button
+    - Change the "Category" to "Macro" if you are sharing a working macro for others to use
+    - Leave the "Category" on "General" if you are asking a question related to the macro
+    - Click on the "Both" button
+    - :!: Note: If you just click on the "New Topic" button, it will NOT upload your macro.
+To move the uploads to an **existing topic**, see instructions below these screenshots.
+{{:share-button-km9.png?nolink|}}\\
+**and then this popup will appear**
+{{:share-macro-to-forum-km9.png?nolink|}}
+**To MOVE to an existing topic, then AFTER the new topic is created:**
   - Select ALL in the new topic
   - CUT the selection
   - Cancel/Abort the new topic
   - Goto the existing topic
-  - Create a reply
+  - Edit the existing post, or Create a reply
   - PASTE into the reply block
-{{:km-toolbar-share-button.jpg?nolink|}}
+See this video:  [How To Upload Macro to Existing Post in Keyboard Maestro Forum](https://www.youtube.com/watch?v=0kkNXZBpWtM)
+----
+==== 2.  Manual Upload ====
+**Follow these steps to manually export your macro to files, then upload**
+  - Click on the macro name in the Keyboard Maestro editor
+  - Goto //File > Export Macro//, and save wherever you'd like
+  - Goto //Edit > Copy as > Copy as Image//
+  - Open Mac Preview app, and goto //File > New from Clipboard//, and save.
+  - Go to the Keyboard Maestro forum thread, and click on reply
+  - Enter some descriptive text,
+  - Use the file upload button  in the Keyboard Maestro Forum Editor to upload both files.
+    - OR drag and drop files from the Finder into the Keyboard Maestro Forum Editor.
+    - OR using most web browsers other than Safari you can copy and paste into the Keyboard Maestro Forum Editor.
+      - Images in the Clipboard or files copied from the Finder can be pasted.
+  - The [Select Clipboard Image File](https://forum.keyboardmaestro.com/t/select-clipboard-image-file/204) macro may also be useful for posting images.
-The items and images shared will be those items SELECTED in the editor.
-In the image above the macro itself is selected, so it and all images related to it will be shared.
+----
-If on the other hand the calculate action WITHIN the macro was selected then ONLY it and its image would be shared.
+The items uploaded (shared) will be those items which are SELECTED in the editor:
+  * If you have selected a macro in the macro list, then it will be uploaded
+  * If you have selected one or more Actions in a Macro, then only the Action(s) will be uploaded.
 ----

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools