MyWord Editor Docs http://myword.smallpict.com/ Sun, 25 Oct 2015 17:24:13 GMT Sun, 25 Oct 2015 17:24:13 GMT en-us Fargo v1.71 http://cyber.law.harvard.edu/rss/rss.html dave.winer@gmail.com davewiner dave.winer.12 MyWord Editor v0.65 http://myword.smallpict.com/2015/04/09/mywordEditorV065.html <p>Andrew Shell posted a note to the <a href="https://groups.google.com/d/msg/server-snacks/GxAVB43bJuI/roD-JeRUbOQJ">mail list</a> yesterday saying he wanted to use the <a href="http://handlebarsjs.com/">Handlebars</a> template system inside MWE. </p> <p>To do so, he's replacing a core routine, multipleReplaceAll. This is too good a routine to give up to such a cause, so I created a shell in <a href="https://github.com/scripting/myWordEditor#v065----4915-by-dw">v0.65</a> for him to replace. </p> <p>The shell is called getRenderedText, and it basically calls multipleReplaceAll. Andrew please use this instead.</p> <p>If the idea of other templating systems catches on, we'll need to formalize this a <em>bit</em> more. <i class="fa fa-smile-o"></i></p> Thu, 09 Apr 2015 14:08:53 GMT http://myword.smallpict.com/2015/04/09/mywordEditorV065.html Code that runs at startup http://myword.smallpict.com/2015/04/03/codeThatRunsAtStartup.html <p>New in <a href="http://myword.io/editor/">MyWord Editor</a> v0.64.</p> <p>There's a new <a href="https://github.com/scripting/myWordEditor/blob/master/config.json">config.json</a> element, config.startupCode. </p> <p>After MWE has finished booting up, it runs this through the built-in eval function.</p> <p>This has proved useful in <a href="http://fargo.io/">Fargo</a>, and other apps, as a way for clever JavaScript devs to extend the environment in some interesting ways. Have fun, but be careful! <i class="fa fa-smile-o"></i></p> <p>The default value is a console.log call that basically says Hello World.</p> Fri, 03 Apr 2015 20:21:18 GMT http://myword.smallpict.com/2015/04/03/codeThatRunsAtStartup.html Toward editor plug-ins http://myword.smallpict.com/2015/04/02/towardEditorPlugins.html <p>I did a little work this week that makes it possible for JavaScript programmers to replace the editor in <a href="http://myword.io/editor/">MyWord Editor</a>. This is in v0.63.</p> <p>There's a new folder in the <a href="https://github.com/scripting/myWordEditor">repository</a> called editor. If you want to use a different editor, say TinyMCE, Dante, medium.js, the editor in Ghost, or whatever you like, just replace the three routines in <a href="https://github.com/scripting/myWordEditor/blob/master/editor/scripts.js">scripts.js</a> in your fork. Having this off in a separate folder gives you space to build functionality you may need.</p> <p>I wrote a bunch more about it on my <a href="http://myword.io/users/davewiner/essays/030.html">MyWord blog</a>, with pointers to blog posts with thinking about the editor. </p> Thu, 02 Apr 2015 21:19:25 GMT http://myword.smallpict.com/2015/04/02/towardEditorPlugins.html Disqus comments in MyWord http://myword.smallpict.com/2015/04/01/disqusCommentsInMyword.html <p>You can include Disqus comments in a <a href="http://myword.io/editor/">MyWord Editor</a> site, starting with v0.62.</p> <ol> <li><p>To enable or disable the feature, visit the CMS tab in Settings. You can turn comments off (they're on by default), or specify a Disqus group. If you want to get email notification of comments on your site, you must change the group. </p></li> <li><p>Comments are provided for in the <a href="view-source:http://myword.io/templates/default.html">default</a> and <a href="view-source:http://myword.io/templates/plain/template.html">plain</a> templates. If you're writing your own template, you can include comments with the [%disquscomments%] macro. </p></li> <li><p>Here's an <a href="http://myword.io/users/davewiner/essays/003.html">example</a> of a page with comments. Feel free to party in the comments section. <i class="fa fa-smile-o"></i></p></li> <li><p>This is not an April Fool joke.</p></li> </ol> Wed, 01 Apr 2015 13:35:33 GMT http://myword.smallpict.com/2015/04/01/disqusCommentsInMyword.html Templates in MyWord http://myword.smallpict.com/2015/03/30/templatesInMyword.html <p>New in <a href="http://myword.io/editor/">MyWord Editor</a> v0.60 -- templates.</p> <p>A quick tour of how they work for writers.</p> <ol> <li><p>There's a new menu in MyWord Editor with the names of all the templates that are available. When you publish a page, we use the template you've chosen.</p></li> <li><p>There's a <i>default</i> template. You can change it in the new CMS panel of Settings. </p></li> <li><p>The sysop can change the contents of the templates popup in config.json. </p></li> </ol> <p>There's much more info about the feature on <a href="http://myword.io/users/davewiner/essays/027.html">this page</a>, which uses the Plain template.</p> <h4>Technical stuff</h4> <p>A template consists of a name and the URL of an HTML file containing the page template.</p> <p>The Plain template is a <a href="view-source:http://myword.io/templates/plain/template.html">good place to start</a> if you want to see how templates are made. </p> <p>Where you see macros, in this [%syntax%], we substitute a value from the pagetable. </p> <p>Items that have ID attributes, like idEssayText and idVersionNumber, are set by the <i>startup</i> script. Your choice. Static substitution, or set by script at read-time. Or elements could be fully dynamic, even AJAXy. I wanted to have the full power of scripting available in the template platform. </p> <p>You can override everything. That's a basic principle. (Maybe not an absolute.) </p> <h4>Roadmap</h4> <p>This is the central feature to the blogging software. In a sense everything is peripheral to the way content flows from author through the templates to the web. If it's done well, at the point of connections, designers can have the maximum power. And we want sysops to have the max flexibility, and make it as easy as possible to host and maintain templates.</p> <h4>Breakage alert</h4> <p>There will certainly be breakage from this point. This is the first place where users and designers get involved in the template process, and this is new software, so it's flexible. Things can change now without breaking an installed base. We're going to take advantage of that. </p> <h4>You will have questions</h4> <p>I do too. Post them here as comments or on the mail list. Even better, write a blog post, and post a link.</p> Mon, 30 Mar 2015 17:53:36 GMT http://myword.smallpict.com/2015/03/30/templatesInMyword.html MyWord Editor v0.59 http://myword.smallpict.com/2015/03/27/mywordEditorV059.html <p>In this version of we release the last bits, the JavaScript code and CSS styles used in rendering the pages that are generated by <a href="http://myword.io/editor/">MyWord Editor</a>.</p> <p>The notes below are important to understand what's been released and how you can use it.</p> <ol> <li><p>The default template that I provide is still wired to the versions of these files on myword.io.</p></li> <li><p>You can modify the default template for your installation in any way you like. That's the point of having a template, so that people can change the appearance of rendered pages without modifying the CMS software.</p></li> <li><p>As part of those modifications, you can point to different versions of the JS and CSS files. </p></li> <li><p>Or you can still point to my copies, and override any style or script you want with your own versions. </p></li> <li><p>I hope to have more template-related features before too long. <i class="fa fa-smile-o"></i></p></li> <li><p>The files are in the <a href="https://github.com/scripting/myWordEditor/tree/master/templates">templates folder</a> in the repository.</p></li> </ol> Fri, 27 Mar 2015 20:39:33 GMT http://myword.smallpict.com/2015/03/27/mywordEditorV059.html The History menu http://myword.smallpict.com/2015/03/27/theHistoryMenu.html <p>In <a href="http://myword.io/editor/">MyWord Editor</a> v0.58 there's a new <em>History</em> menu.</p> <p>When you choose an item in the menu, its title, description, image URL and body text appear in the dialog. You can edit them, publish, whatever. </p> <p>If you change the title of a post, or add a new one, the History menu automatically updates.</p> <p>The <em>Open file</em> command is no longer needed, so it was removed.</p> Fri, 27 Mar 2015 16:49:15 GMT http://myword.smallpict.com/2015/03/27/theHistoryMenu.html MyWord Editor v0.55 http://myword.smallpict.com/2015/03/26/mywordEditorV055.html <p>One feature, three fixes in <a href="http://myword.io/editor/">MyWord Editor</a> v0.55. </p> <ol> <li><p>Each post now has a sidebar, which you can access by clicking on the hamburger icon in the upper left corner of the page. When you open it, you'll see a list of recent posts. The current post is displayed bold. Click on any other post to view it. This list is generated from the RSS feed for the user's blog. Here's a <a href="http://myword.io/users/davewiner/essays/018.html">post</a> that illustrates. </p></li> <li><p>Fixed a CSS problem that had list line-height fixed in some cases. All paragraphs in the body should now have a height of 145%.</p></li> <li><p>When generating &lt;description> elements in the feed for the blog, we pass it through a markdown interpreter, since the assumption is that all text in MWE is markdown. If it's markdown text, we also generate a &lt;source:markdown> element that contains the original text, so if the RSS reader app can understand markdown it could do something special with it. </p></li> <li><p>Modified the default template so it includes the title, description and body text in the page elements, not just in the pagetable. This should guarantee that the text is picked up by the search engines. Let's watch for this and see if it does.</p></li> </ol> Thu, 26 Mar 2015 16:42:38 GMT http://myword.smallpict.com/2015/03/26/mywordEditorV055.html MyWord Editor v0.47 http://myword.smallpict.com/2015/03/20/mywordEditorV047.html <p>We now have an easy way to host your myword.io blog on another server. This will expand, get simpler and easier, and less buggy, I promise. But for now this is how you do it. </p> <h4>How to</h4> <ol> <li><p>In <a href="http://myword.io/editor/">MyWord Editor</a>, choose <i>Switch server</i> in the Editor menu.</p></li> <li><p>Enter the URL of one of my servers, <code>http://twitter.noteblog.io/</code></p></li> <li><p>Important: It must be in exactly that form, no trailing blanks, the final slash must be present. </p></li> <li><p>Click OK. You should be redirected to Twitter with a page asking you to authorize noteblog.io. Authorize it. </p></li> <li><p>You should be brought back to the editor. Fill in the form with a new post, click Publish, then OK to visit the page.</p></li> </ol> <p>That's it. You should now have a post on noteblog.io. Here's an <a href="http://noteblog.io/users/davewiner/essays/001.html">example</a>. Please test this and report back via the mail list or a comment here. </p> <h4>If it all worked</h4> <p>You should now have an essay on noteblog.io, which is a spare nodeStorage server I had. It's a plain vanilla server, installed from the nodeStorage source on GitHub.</p> <p>If you have your own <a href="https://github.com/scripting/nodeStorage">nodeStorage</a> server, you should be able to substitute your domain for mine, and repeat the process. Just remember, it must be in the form of a URL, or it won't work. (See #3 above.)</p> <h4>How this will improve</h4> <p>You will be able to put a JSON file in the same directory as your copy of MWE that says where your server is, so the user doesn't have to do anything special to set it up, and you don't have to modify the MWE source to start your own hosting service.</p> <h4>Roadmap for deployment</h4> <p>I am announcing this on the server-snacks mail list for testing with people who have nodeStorage servers set up, and on the myword-editor mail list for people who are testing the editor. I'm doing this <em>before</em> opening MWE to the public, so on Day One there may be a number of servers they can use, not just mine. At least we will have tested it's silo-freeness, and been sure that it works.</p> <p>I will also release the full source for MWE in a GitHub repository. This should allow compatible experimentation and innovation in editors. </p> <p>Here's a Scripting News <a href="http://scripting.com/2015/03/19/mywordEditorWillBeSilofreeFromTheStart.html">blog post</a> explaining the philosophy.</p> Fri, 20 Mar 2015 14:20:01 GMT http://myword.smallpict.com/2015/03/20/mywordEditorV047.html MyWord Editor v0.42 http://myword.smallpict.com/2015/03/07/mywordEditorV042.html <p>One new feature, a couple of fixes.</p> <ol> <li><p>If you want to open a file you created previously, choose Open File from the Editor menu. Make changes, publish, everything should work.</p></li> <li><p>Autosave is now more conservative, only saving after a second of idleness. So if you want to save, just let up on the keyboard as you type. In the upper right corner of the screen next to the version is a SAVED indicator. It flashes while MWE is saving.</p></li> <li><p>There was a bug where blank lines would accumulate at the end of the document. This has been fixed.</p></li> </ol> <h4>If you want to try it out</h4> <p>Leave a comment below with your Twitter ID. </p> <p>If you have problems use the <a href="https://groups.google.com/forum/?fromgroups#!forum/myword-editor">mail list</a>. </p> <p>Don't forget how to <a href="http://scripting.com/2014/03/19/howToAskForHelpWithSoftware.html">ask for help</a> with software.</p> Sat, 07 Mar 2015 16:31:20 GMT http://myword.smallpict.com/2015/03/07/mywordEditorV042.html Welcome to MyWord Editor http://myword.smallpict.com/2015/03/06/welcomeToMywordEditor.html <p><a href="http://myword.io/editor/">MyWord Editor</a> is a simple browser-based editor that publishes to the web.</p> <h4>Example</h4> <p>Here's an <a href="http://myword.io/users/davewiner/essays/045.html">example</a> of the kind of document it produces. </p> <h4>How to</h4> <p>To create a new document, just load the MyWord Editor <a href="http://myword.io/editor/">page</a>, if a document is already present, choose the New command in the Editor menu. The fields of the form clear. Enter a title, description and body for the post. </p> <p>The text is automatically saved as you type. </p> <p>When you want to publish your essay, choose Publish from the Publish menu. To view the published page, click OK on the confirmation dialog that appears.</p> <h4>Advanced features</h4> <ol> <li><p>In the Publish menu, choose <i>View story</i> to view the published page.</p></li> <li><p>In the Editor menu, choose <i>View RSS feed</i> to view the feed containing your essays.</p></li> <li><p>Choose <i>Get JSON backup</i> to view an data file (in JSON) containing all your posts, so you can transfer them to another account or application, or to serve as a backup. </p></li> </ol> <h4>Using Markdown</h4> <p>You can use Markdown in a limited form, but you have to turn it on first.</p> <ol> <li><p>Choose the Settings command from the system menu (it's at the right edge of the menu bar, the menu with your username as its title).</p></li> <li><p>In the Publish panel, click the checkbox for "Use the Markdown processor."</p></li> <li><p>Click OK. </p></li> </ol> <p>There are limits to our Markdown support. </p> <ol> <li><p>Markdown works within paragraphs, so if you put asterisks around some text, you'll get italic text. And you can put pound signs in front of a headline to get it properly boldened and enlarged.</p></li> <li><p>But any Markdown construct that spans more than one paragraph is ignored. The Markdown model says they don't look inside paragraphs, a good policy. So there's a little bit of Markdown support in here, not full support.</p></li> </ol> <h4>Support mail list</h4> <p>If you have questions post them here as a comment, or on the <a href="https://groups.google.com/forum/?fromgroups#!forum/myword-editor">support mail list</a>.</p> Fri, 06 Mar 2015 15:23:07 GMT http://myword.smallpict.com/2015/03/06/welcomeToMywordEditor.html