The Datafile PD-CD 5

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

/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / h / htmlkeys2 / HTML / Help < prev

Wrap

Text File | 1995-11-14 | 19.9 KB | 632 lines

<HTML> <HEAD> <TITLE> Quick guide to HTML key bindings </TITLE> <LINK REV="made" HREF="mailto:andy@websvcs.demon.co.uk> </HEAD> <BODY BGCOLOR="#FFFFFF" BACKGROUND="graphics/node.gif" TEXT="#000000" LINK="#001DFF" VLINK="#FF8080"> <H1 ALIGN=CENTER>The Zap HTML Keymap</H1> <HR ALIGN=CENTER WIDTH="25%"> This is the second release of the HTML Keybindings for Zap! Originally developed under the codename 'Milton Keynes' and having passed through an exhaustive 1 hour beta testing session keymap is now on official release. As of now, the files will be publicly known as HTMLMap 95 ®. HTMLMap 95® will revolutionise the way you work. Within 1 hour 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 guarantee you that you will soon find HTML authoring 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 originally knocked up this 13K of documentation in about 2 hours, and it's actually quite complex. Yes, really! (It's 19K now, as I've filled it out a bit, and there have been some <A HREF="changes.html">changes</A> between versions.) Anyway, here's the Contents page! <HR> <H2 ALIGN=CENTER>The Contents Page</H2> <H3>  <OL> <LI> <A HREF="#Legal">The Legal Guff</A> <LI> <A HREF="#Install">Installation</A> <LI> <A HREF="#Overview">Overview</A> <LI> <A HREF="#KeyCut">Keycut Rundown</A> <OL> <LI> <A HREF="#NonHTML">Non-HTML keys common to both maps</A> <LI> <A HREF="#HTML">HTML keys common to both maps</A> <LI> <A HREF="#Create">Creation Map Keycuts</A> <OL> <LI> <A HREF="#Simple">The Simple Ones</A> <LI> <A HREF="#LessSimple">The Less Simple Ones</A> <LI> <A HREF="#Lists">Lists</A> </OL> <LI> <A HREF="#Markup">Markup Map Keycuts</A> </OL> <LI> <A HREF="#Bugs">Known Bugs</A> </OL> </H3> <HR> <A NAME="Legal"></A> <H2 ALIGN=CENTER>Legal Guff</H2> Don't come running to me in the event that this keymap does something unlikely, such as trashing your computer or harddisc, eating your dog, or invading Poland and starting World War III. This keymap and its associated documentation are © Andrew Ward 1995 and are released as Freeware into the Pubic Domain in the hope that others 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 slap it on a disc as long as the charge per disc is reasonable.) [Sorry, I had to put that last bit in otherwise this'll be on sale at LongCo or some such ] <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)"> Distribute freely, though please don't separate the documentation from the Keys file. <H3>Acknowledgments</H3> Thanks to Dom Symes firstly for the excellent Zap (without which I would be wasting my time now <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)"> and secondly for the default keymap which this HTML keymap is appended to. <HR> <A NAME="Install"></A> <H2 ALIGN=CENTER>Installation</H2> Note: This keymap is designed for use with Zap 1.30. It will not work with any earlier versions without some alterations. Get version 1.30 - It's great! <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)"> Basically, 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 tentacles (this keymap is more 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. All my stuff is at the end. </OL> <HR> <A NAME="Overview"></A> <H2 ALIGN=CENTER>Overview</H2> 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. Especially when it's based around Edit! Yeuck <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 cheesy <A HREF="http://you.don't.wanna.do.that!"> Netscape</A> 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> Having said all that, this keymap is not for those who haven't got the first clue about writing HTML. Presently, if you want a WYSIWYG editor for an Acorn your only option is to use Impression with Ben Summer's saver's. Anyway, back to business, 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. It also will automatically convert all those top bit characters into their proper HTML entities. There are two new keymaps, for two different methods of document creation, though they are broadly similar. <H3>HTML Creation Map</H3> The first keymap 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, OK) 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> My Acorn Computer's great. 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="> and </A> so you get: <CODE> My <A HREF="">Acorn Computer's</A> great. 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 quote ready for you to type in the rest of the URL. I've also pinched the Fresco convention, where hitting Tab will enter <CODE>http://www.</CODE> and Shift-Tab enters <CODE> ftp://ftp.</CODE> Simple, yeah? Anyway, enough of the waffle; here's the definitive listing of what keycuts do what. <HR> <A NAME="KeyCut"></A> <H2 ALIGN=CENTER>Keycut Rundown</H2> 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 gets a bit messy with multiple keymaps, since there is no way of saving the previous keymap you were using. <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. <A NAME="NonHTML"></A> <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 cV (This used to be ctrl-M but I got fed up with the inconsistency :) Clear Selection cZ Select Word at cursor cW </PRE> <A NAME="HTML"></A> <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-Q <DD> Inserts the quote entity " (") <DT> £ <DD> Inserts the £ sign. (£) Note, usage of Ctrl-Shift-L is now depreciated ;-) . </DL> As well as using the above keys for the most commonly used entities, you will find that if you use Chars (or a similar utility), or even whack in the ASCII value with ALT held down, the HTML entity will be entered for you. Where available I've used the legal entity name (e.g Á) rather than use the generic ASCII value. However, where I do use the ASCII value you'll also get the full 8 bit character contained in a comment, so you know what it is when you come back in future (e.g ASCII 178 inserts <CODE>² --></CODE> into your source.) If you don't like it, you know what you can do with it, don't you <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)">! Note, that if you use the system font in Chars then you must have the ISO-Latin-1 alphabet selected, otherwise you won't get what you expected appearing. As I mentioned earlier on, hitting Tab or Shift-Tab will enter <CODE>http://www.</CODE> and <CODE>ftp://ftp.</CODE> respectively. I deliberately haven't bound gopher to Ctrl-Tab since I use Coolswitch from Andy Armstrong which gives Window's ® style ALT & Ctrl Tab'ing, and this interferes with it. I was going to bind Ctrl-Shift-Tab to a real TAB, but I also use the excellent Director from Nick Craig-Wood, which has the memoriser mapped to that keypress. B*gger! Too many patches <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)">! Besides, I think I can count the number of times I've entered <CODE>gopher://gopher.</CODE> in a HTML document on the fingers of one hand. Some of you may not like Tab being bound to something as silly as http://www but I wanted to stay true to the Fresco convention. If you don't like it, unbind it, or Ctrl-Q it. If it's any consolation, <A HREF="#Lists">lists</A> automatically indent themselves. One final set of keycuts common to both maps are the Ctrl-Shift-Cursor keys. Ctrl-Shift-Left and Ctrl-Shift-Right skip backwards and forwards between attributes. (The search pattern is ="). This feature is very useful for swapping between, say, the SRC and the ALT attributes of an IMG tag. Ctrl-Shift-Up and Ctrl-Shift-Down go to the beginning of the previous tag, and the end of the next, respectively. Try it and see. <A NAME="Create"></A> <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. <A NAME="Simple"></A> <H4>The Simple ones</H4>  <PRE> Key Ctrl Ctrl-Sh ============================================ A <A HREF=""> </A> B D <DFN> </DFN> E I K <KBD> </KBD> L Go to list Keymap for next key only M <META > N <A NAME=""> Easter Egg P <PRE> </PRE> Q Next keypress only goes to default keymap R  (LET R = REM) S T <TT> </TT> U (Underline) 1 <H1> </H1> 2 <H2> </H2> ... 3-5 left as an exercise to the reader ... 6 <H6> </H6> </PRE> <A NAME="LessSimple"></A> <H4>The Less Simple ones</H4> (The ones I couldn't fit in the table sensibly <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)">! <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"> ALT=""</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 <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)">? <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"> ALT=""</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 <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)">! <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> <A NAME="Lists"></A> <H4> The List Keymap </H4> By hitting Ctrl-L in the keymap, the next key goes to this map (after a key is pressed, you revert back to the old keymap). This allows you to have all the list tags mapped to keys in a semi-sensible fashion, and still apply all the previous tags to text in a list. <PRE> Key Ctrl Ctrl-Sh ============================================ D <DL> </DL> E <DD> (E valuates to) L <LI> M <MENU> </MENU> O <OL> </OL> T <DT> (T erm) U <UL> </UL> </PRE> Remember you have to precede each of these keypresses by Ctrl-L to enable the keymap. Also note that the the lists try to autoindent (and outdent) themselves to help readability. I included this because the Tab key seems to have buggered off and become http://www. <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)"> . E.g Try entering a definition list, and watch the Definition indent by a tab, and the following Term outdent again. OK! That's most of it out the way. Now for the Markup Section ... <HR> <A NAME="Markup"></A> <H3>HTML keys for Markup Keymap</H3> <SPEECH TYPE="Jack Dee" Value="Well_known_beer_ad"> 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 <IMG SRC="graphics/smile.jpg" ALIGN=MIDDLE ALT=":-)">! Basically, all the keys are mapped onto the same tags, except, when you apply a container tag, such as you end up with the tags put around the selected text. This is really all one big bodge, so it <A NAME="NOSEL">only</A> works properly when you have a selection highlighted. If you don't, you will find whatever you selected last slapped inbetween the container tags. This is basically 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 it couldn'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. Oh, and if you don't like your tags in capitals tough, 'cos I do! <HR> <A NAME="Bugs"></A> <H2 ALIGN=CENTER>Known Bugs</H2> <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! <IMG SRC="graphics/smile.jpg" ALIGN=CENTER ALT=":-)"> That'll be it then! Any problems, bugs (Ha!), requests, remunerations etc. to the Netscape enhanced email address below. <HR> <H1 ALIGN=CENTER> <IMG SRC="graphics/Globe.jpg" ALIGN=CENTER ALT=""> CONNECTIV <IMG SRC="graphics/Globe.jpg" ALIGN=CENTER ALT=""> </H1> <ADDRESS> <A HREF="mailto:andy@websvcs.demon.co.uk">andy@websvcs.demon.co.uk</A> </ADDRESS> </BODY> </HTML>