RISC DISC 2

home *** CD-ROM | disk | FTP | other *** search

/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / apps / zap / HTMLKeys / ReadMe < prev

Wrap

Text File | 1995-09-20 | 12.8 KB | 456 lines

<HTML> <HEAD> <TITLE> Quick guide to HTML key bindings </TITLE> </HEAD> <BODY> <H1>The Zap HTML Keymap</H1> This is the All New HTML Keybindings for Zap! This keys file will revolutionise the way you work. Within 2 hours of starting to use this key map we promise you that you will no longer consider HTML coding to be a chore, or your money back! Yes! We guarentee you that you will soon find HTML creation more fun than a dirty weekend with Pamella Anderson! Honest! Well, OK; that's a slight exaggeration, but it does make some things easier. For instance, I knocked up this 12K of documentation in about 2 hours, and it's actually quite complex. Yes, really! Anyway, here's the Contents page! <H2>The Contents Page</H2> <H3 ALIGN="center"> <A HREF="#Legal">The Legal Guff</A> <A HREF="#Install">Installation</A> <A HREF="#Overview">Overview</A> <A HREF="#KeyCut">Keycut Rundown</A> <A HREF="#Bugs">Known Bugs</A> </H3> <HR> <A NAME="Legal"> <H2>Legal Guff</H2> </A> Don't come running to me in the unlikely event that this keymap trashes your computer or harddisc, eats your dog, or invades Poland to start World War III. This keymap and associated documentation is © Andrew Ward 1995 and are released as Freeware into the Pubic Domain in the hope that some people will find it useful. Feel free to alter it to suit your tastes, though. Finally, don't even think about charging money for it! (PD libraries may charge enough to cover their costs though) Distribute freely, though please don't separate the documentation from the Keys file <H3>Acknowledgment</H3> Thanks to Dom Symes firstly for the excellent Zap (withouut which I would be wasting my time now :-) and secondly for the default keymap which this HTML keymap is appended to. <HR> <A NAME="Install"> <H2>Installation</H2> </A> To install this keys file you must be one of two sorts of Zap user: <OL> <LI>You are the apprehensive/easy-to-please type and haven't altered the default Zap keymap. This is great, because all you have to do is drag this Keys file over the default Keys file inside the Zap application, and Bob's your uncle. <LI>You are the stubborn, awkward type who has completely customised your keys file to your liking, so as to make optimum use of your 12 fingers and 3 tenticles (commonly known as the vi bindings). You also have the alphabet mapped in such a way that everything you type is automatically ROT13'd. In short you are a pain in the arse, and since you obviously know what you're doing I'll leave it up to you to munge the two keymaps together. </OL> <HR> <A NAME="Overview"> <H2>Overview</H2> </A> This Zap keymap is for those of you who like to edit their HTML by hand, for whatever reason: <UL> <LI> You haven't got Impression or don't want to give Ben Summers any money for his HTML loaders/savers. <LI> You don't want to line Andrew Rawnsley's pockets with 30 quid for !HTMLEdit. <LI> You get some perverse gratification from seeing < and > characters all over your screen. <LI> You actually need the power of editing HTML directly so you can add all those cheesey Netscape hacks that Acorn WYSIWYG editors don't support. <LI> Or you might even (Shock! Horror!) want to code some proper HTML3. <LI> In my case, it's all the above. </UL> Anyway, this Zap keys file takes some of the pain and tedium out of editing HTML by hand by providing a load of key shortcuts for some commonly typed tags. There are two new keymaps, for two different methods of document creation, though they are broadly similar. <H3>HTML Creation Map</H3> The first kemap is for creating HTML on a blank page, so that you can type the tags in on the fly, as and when you need to put them in your text. i.e Typing <KBD> The best text editor for the [Ctrl-E] Acorn [Ctrl-Sh-E] range of computers is [Ctrl-S] Zap [Ctrl-Sh-S]. </KBD> (Where [Ctrl-S] means pressing Control and the letter S simultaneously, and [Ctrl-Sh-S] means pressing Control, Shift and S simultaneously, stupid) will produce HTML that looks like: <CODE> The best text editor for the Acorn range of computers is Zap. </CODE> Which would should hopefully get rendered as: The best text editor for the Acorn range of computers is Zap. <H3>HTML Markup Map</H3> The second keymap is for marking up an existing text file. Basically you can highlight the region you want to apply the tag to and hit the keycut to put the HTML markers around it. For example, take the following pre-typed paragraph in Zap: <CODE> I love my Acorn Computer. It's just so damn easy to use, and combined with the all-singing all-dancing editor, Zap, HTML editing is a breeze. </CODE> By high-lighting the words Acorn Computer and hitting [Ctrl-A] Zap will enclose the selection with <A HREF="http://"> and </A> so you get: <CODE> I love my <A HREF="http://">Acorn Computer</A>. It's just so damn easy to use, and combined with the all singing all dancing editor, Zap, HTML editing is a breeze. </CODE> Not only that, but it will also place the cursor after the '//' ready for you to type in the rest of the URL. Simple, yeah! Anyway, enough of the waffle; here's the definitive listing of what keycuts do what. <HR> <A NAME="Keycut"> <H2>Keycut Rundown</H2> </A> I've tried to make the keys obvious, or at least attach the most used tags to the obvious keys, though some of this is pretty subjective. Feel free to hack it round if you want. I haven't been able to get all the baseline HTML2 tags allocated to keys, because I ran out of letters, and using Meta keypresses for entering 4 letter tags like <DT> is a waste of time IMO. <H3>Conventions</H3> I'm using the Zap Keys file convention of c for Control and s for Shift though I'll undoubtedly change my mind just to keep you on your toes. <H3>Non-HTML Keycuts common to both keymaps</H3> <PRE> Action Key ============================================ Change to HTML Creation Mode c\ Change to HTML Markup Mode cs\ Return to Default Keymap Esc Pass next key to default keymap cQ Copy Selection cC Cut Selection cX Move Selection cM (Sorry cV was already taken :) Clear Selection cZ Select Word at cursor cW </PRE> <H3>HTML related keys common to both maps</H3> <DL> <DT> Ctrl-Shift-7 (Ctrl-&) <DD> Inserts the escaped ampersand , & (&) <DT> Ctrl-Shift-9 (Ctrl-( ) <DD> Inserts the escaped version of < (<) <DT> Ctrl-Shift-0 (Ctrl-) ) <DD> Inserts the escaped version of > (>) <DT> Ctrl-Shift-C <DD> Inserts the © symbol (©) Be aware that © is a dreaded Netscapism, whereas © is the agreed W3 standard for the copyright symbol. <DT> Ctrl-Shift-L <DD> Inserts the £ sign. (£) </DL> <H3>HTML keys for Creation Keymap </H3> Probably the best way to remember what keys do what is to fire up Zap and have a go. As mentioned above, Ctrl-\ changes to the HTML creation keymap. So, do that then suck it and see. <H4>The Simple ones</H4>  <PRE> Key Ctrl Ctrl-Sh ============================================ A <A HREF=" </A> B D <DL> </DL> E I K <KBD> </KBD> L <LI> Inserts a £ (£) N <A NAME=" Easter Egg O <OL> </OL> P <PRE> </PRE> R  (LET R = REM) S T <TT> </TT> U <UL> </UL> V <VAR> </VAR> 1 <H1> </H1> 2 <H2> </H2> ... 3-5 left as an exercise to the reader ... 6 <H6> </H6> </PRE> <H4>The Less Simple ones</H4> (The ones I couldn't fit in the table sensibly :-) <DL> <DT> Ctrl-F <DD> Inserts <CODE> <FORM METHOD="POST" ACTION=" </CODE> <DT> Ctrl-Shift-F <DD> Inserts <CODE> </FORM> </CODE> <DT> Ctrl-G <DD> Inserts an inline GIF as in : <CODE> <IMG SRC=".gif"> </CODE> and puts the cursor before the dot of .gif ready for you to type in the URL. Gosh! Aren't I kind saving you all those keypresses :-) <DD>In a perfect world this would be mapped to Ctrl-I but that's already pinched by Besides G was unallocated, and the alternative was J ... <DT> Ctrl-J <DD> Which nicely inserts an inline JPEG comme ça :<CODE> <IMG SRC=".jpg"> </CODE> and again conveniently places the cursor before the dot. <DT> Ctrl-H <DD> Puts the basic HTML Header around a document. ie. <PRE> <HTML> <HEAD> <TITLE> </TITLE> </HEAD> <BODY> </BODY> </HTML> </PRE> <DD>Any text previously on the page will be left between the BODY tags. Don't forget to put some text in for the TITLE. If you want to add your Netscape pretties to the BODY section do it yourself :-) <DT> Ctrl-RETURN <DD> Puts in a line Break : <DT> Shift-RETURN <DD> Inserts a paragraph break (sic) : <DT> Ctrl-Shift-RETURN <DD> Inserts the close paragraph tag : </DL> OK! That's most of it out the way. Now for the Markup Section ... <HR> <H3>HTML keys for Creation Keymap</H3> <SPEECH TYPE="Jack Dee" Value="Sarcastic"> Oh... I can't do this! </SPEECH> Yep, I really can't be bothered to go through all the same stuff again going over the minor differences between the Creation and Markup maps! I've got better things to do :-) Basically, all the keys are mapped onto the same tags, except, when you apply a container tag, such as you <A NAME="NOSEL"> must</A> have a selection highlighted. If you don't, you will find whatever you selected last slapped inbetween the container tags. This is because, what the macro does is a process of <OL> <LI>Cut Selection. <LI>Insert start tag. <LI>Paste back selection. <LI>Insert end tag. </OL> And if you didn't cut anything in step one you'll paste rubbish back. In short don't do it. If you need create HTML put yourself in Creation mode, and if you want to markup make sure you're in Markup mode. Right, that's it! Simple yeah? If you want to change anything, feel free, though if you make any majorly useful changes I'd appreciate a copy. If you don't like your tags in capitals tough, 'cos I do! <HR> <A NAME="Bugs"> <H2>Known Bugs</H3> </A> <UL> <LI>There appears to be a bug in Zap's redraw code that leaves behind a ghost cursor when a complex series of 'INSERTs' are carried out. This is especially visible when using the [Ctrl-H] 'Header' keycut. Redrawing the window sorts it out. <LI>Using the container tags in the markup mode without a selection. See <A HREF="#NOSEL">above</A> </UL> Everything else is your fault! That'll be it then! Any problems, bugs (Ha!), requests, remunerations etc. to the Netscape enhanced email address below. <HR> <ADDRESS> <A HREF="mailto:andy@websvcs.demon.co.uk">andy@websvcs.demon.co.uk</A> </ADDRESS> </BODY> </HTML>