Differences

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

--- Forum [2015/11/12 20:23]
ccstone [Using the Keyboard Maestro Forum.]
+++ Forum [2021/02/03 18:32]
JMichaelTX [1. Upload Using Share Button]
@@ Line 1: / Line 1: @@
-===== Using the Keyboard Maestro Forum. =====
+[[https://forum.keyboardmaestro.com|{{:forum-icon.jpg |Go To Forum}}]]
+====== Using the Keyboard Maestro Forum ======
+===== Where To Post =====
+  * 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.
 ----
-Please direct questions and comments to me: [[kmforum@thestoneforge.com|Christopher Stone]]
+===== 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.
 ----
-==== Sharing Images and Macro Files on the Forum ====
-You can drag and drop files directly from the Finder into the forum editor.
+===== How To Get Help =====
-In Firefox, Google Chrome, and Opera you can directly paste images from the clipboard, image files, KM-specific files, and zip files.
+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.
-(Safari only allows drag and drop.  Google Chrome, Firefox, Opera, and some others allow paste.)
-The simplest way to share something is to use the Keyboard Maestro Editor's own Share button (see image below).
+----
-{{ :km-toolbar-share-button.jpg?nolink |}}
+==== 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 `site:forum.keyboardmaestro.com` along with your keywords:\\  [[https://www.google.com/search?q=site%3Aforum.keyboardmaestro.com%20YourKeywords|site:forum.keyboardmaestro.com YourKeyWords]]
-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.
+==== Posting Your Question or Issue to the Forum ====
-So.
-You can share a whole macro.
+**Avoid the [[http://xyproblem.info|XY Problem]] of asking about your attempted //solution// rather than your //actual problem//:**
+  * 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.
-Or.
+**If you are having trouble with a macro and want help, then please post:**
+  * Your question with as much detail as you can
+  * If it involves processing data, provide real world (not madeup) examples of:
+    * Your source input data
+    * How you want the data to appear after processing by your macro
+  * Upload both your macro image and code (export of macro)
+    * 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]]
-You can share only parts of a macro.
+**For help on using the Forum Editor**, see [[Using Markdown in the Keyboard Maestro Forum]]
-You can also copy the selected macro or action(s) as an image:
+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.
-{{ :km-copy-as-image.jpg?nolink |}}
-All of this is not quite as quick and easy as composing an email on your Mac, but it's not all that bad once you get used to it.
+----
+===== How to Post/Upload Your Macro to the Forum =====
+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
+  - Edit the existing post, or Create a reply
+  - PASTE into the reply block
+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 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.
+----
- --- //[[kmforum@thestoneforge.com|Christopher Stone]] 2015/11/12 20:19//
+ --- //Original article posted by:  [[kmforum@thestoneforge.com|Christopher Stone]] 2015/11/12 20:19//

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools