Omnimaga

Calculator Community => TI Calculators => Axe => Topic started by: Deep Toaster on September 25, 2011, 11:20:20 pm

Title: Third-party Axe tutorial
Post by: Deep Toaster on September 25, 2011, 11:20:20 pm
Something I've always wanted to write is a complete tutorial on coding in Axe, and it seems like nobody's done a full one in English yet (kindermoumoute has one in French (http://www.siteduzero.com/tutoriel-3-400701-l-axe-parser.html), and SirCmpwn had been working on one in English (http://omniurl.tk/3470/) but never finished and is now gone), so I've started. All I have done is an introduction (http://clrhome.org/tutorials/axe/), but I've already set up the layout for everything, and I'm planning to combine some of my old (shorter) tutorials to fill in the holes in this one. Comments and suggestions are very welcome :)
Title: Re: Third-party Axe tutorial
Post by: LincolnB on September 25, 2011, 11:28:24 pm
Ooh, very cool. This will be very useful, as I've seen a lot of new people around. I am always here, if you need any help with anything at all.
Title: Re: Third-party Axe tutorial
Post by: DJ Omnimaga on September 25, 2011, 11:32:59 pm
Nice. Also if you want to you can upload it in the Omni tutorials section (and link to this thread) ^^ http://www.omnimaga.org/index.php?action=articles;cat=11
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on September 25, 2011, 11:51:13 pm
Oh, forgot to mention that part. Yes, I will definitely convert it to BBCode to post here when I'm done with a significant portion, but not before. I always kept my "arrays" and "SHMUP" tutorials updated everywhere it was posted, and updating copies on three different forums with three different BBCode syntaxes every time I changed a URL or image got to be really annoying x.x
Title: Re: Third-party Axe tutorial
Post by: Michael_Lee on September 26, 2011, 12:08:53 am
I really like the image for chapter 1, and the expanding Javascript expanding thing :)

Question: Are you planning to take a 'here's how to do things, quickly' approach, or a more comprehensive 'bottoms-up' approach where you discuss the internals of the calc first?
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on September 26, 2011, 12:30:27 am
Question: Are you planning to take a 'here's how to do things, quickly' approach, or a more comprehensive 'bottoms-up' approach where you discuss the internals of the calc first?
Bottoms-up. I'm planning to make this (http://omniurl.tk/6568/126758/) page 2 and a mini-tutorial on binary/hexadecimal page 3. The PDF in the Axe package is one of the best quick-start guides I've seen for any language.
I really like the image for chapter 1, and the expanding Javascript expanding thing :)
Yeah, I worked a lot on that slide thing :)

And as for http://clrhome.tk/tutorials/axe/what.png (http://clrhome.tk/tutorials/axe/what.png), I got the idea from the Wikipedia logo XD
Title: Re: Third-party Axe tutorial
Post by: aeTIos on September 26, 2011, 07:01:22 am
Epic intro :D
Also those images are like molecules ;D
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on September 26, 2011, 09:32:54 am
Epic intro :D
Thanks. I managed to find an amazingly appropriate quote :D
Title: Re: Third-party Axe tutorial
Post by: shmibs on September 26, 2011, 11:30:41 am
ooh, everything is all shlick and shiny.

i love the over all feel, if nothing else, and i know you explain things well, so it should be fantastic.
Title: Re: Third-party Axe tutorial
Post by: squidgetx on September 26, 2011, 11:56:29 am
Hot. Nice job, I remember back in the days when I started trying to learn TI-BASIC off these obscure tutorials online; we definitely need an axe one.
Title: Re: Third-party Axe tutorial
Post by: Scipi on September 26, 2011, 12:30:27 pm
Oh, I've been waiting for something like this. A lot of the tutorials out there for Axe just don't do it for me. :D
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on September 26, 2011, 06:19:20 pm
I'm now working on Lesson 2: Playing with Data (http://clrhome.org/tutorials/axe/02/) (an explanation of data and pointers) before I do that comparison page.
Title: Re: Third-party Axe tutorial
Post by: parserp on September 29, 2011, 10:12:11 pm
Very nice. this is the tutorial I've been waiting for. ;D
Title: Re: Third-party Axe tutorial
Post by: mrmprog on September 29, 2011, 11:37:28 pm
/me has been looking for this!
 Seems like a good thing for begginers.I think it is one of the few english general tutorials i have seen. Good work.
Title: Re: Third-party Axe tutorial
Post by: parserp on September 29, 2011, 11:41:45 pm
/me has been looking for this!
 Seems like a good thing for begginers.I think it is one of the few english general tutorials i have seen. Good work.
Seriously! those french ones don't make any sense. especially because I don't speak french. :P
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on October 05, 2011, 12:54:23 am
/me has been looking for this!
 Seems like a good thing for begginers.I think it is one of the few english general tutorials i have seen. Good work.
Seriously! those french ones don't make any sense. especially because I don't speak french. :P
I can see how that would work lol

By the way, anybody want to help write it?
Title: Re: Third-party Axe tutorial
Post by: NecroBumpist on October 05, 2011, 12:59:22 am
Can't wait for this, I really need to learn Axe :)
Title: Re: Third-party Axe tutorial
Post by: parserp on October 05, 2011, 01:07:08 am
/me has been looking for this!
 Seems like a good thing for begginers.I think it is one of the few english general tutorials i have seen. Good work.
Seriously! those french ones don't make any sense. especially because I don't speak french. :P
I can see how that would work lol

By the way, anybody want to help write it?
I would be glad too, except I would have to learn axe first. :P
I think I'd be more on the side of learning from it...
Title: Re: Third-party Axe tutorial
Post by: LincolnB on October 06, 2011, 09:51:49 pm
/me has been looking for this!
 Seems like a good thing for begginers.I think it is one of the few english general tutorials i have seen. Good work.
Seriously! those french ones don't make any sense. especially because I don't speak french. :P
I can see how that would work lol

By the way, anybody want to help write it?

Sure. Not entirely sure exactly what I could help with. Maybe buffers. I'm into those these days :)
Title: Re: Third-party Axe tutorial
Post by: squidgetx on October 07, 2011, 03:08:22 pm
Deep: I'd be glad to help :) PM me any specific sections/articles
Title: Re: Third-party Axe tutorial
Post by: AngelFish on October 07, 2011, 03:29:33 pm

By the way, anybody want to help write it?

I'd be happy to contribute a few things if you want to PM me. I think Runer is the Axe expert though :P
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on October 10, 2011, 12:32:34 am
Glad you're willing to contribute! I still haven't decided on the flow of the tutorial yet, but when I do I'll tell you :D

New page up. (Skipped ahead to page 07 :P) Since it's a tutorial on its own, there's a topic about it here (http://ourl.ca/13416.new#new).
Title: Re: Third-party Axe tutorial
Post by: boot2490 on October 10, 2011, 11:23:51 am
I like how the text shrinks when you go down! That is one cool effect.
Title: Re: Third-party Axe tutorial
Post by: aeTIos on October 11, 2011, 10:51:30 am
so how's this going?
Also, I would be glad if I could contribute to this. I think we should create one big, community-written tutorial.
Title: Re: Third-party Axe tutorial
Post by: LincolnB on October 11, 2011, 02:47:29 pm
Hey, it'd be great if you could have a controlled discussion environment of sorts at the bottom of each tutorial, where people can post their comments and stuff on that particular tutorial. Or, better yet, you could implement a system as Steve Yegge described on his blog:

http://steve-yegge.blogspot.com/2006/03/blog-or-get-off-pot.html

The part that I'm talking about (if you don't feel like copy/pasting the URL into the bar thing) is in a spoiler below:

Spoiler For Spoiler:
I hate blogs.

It's not that I hate them, really; I just don't like the "diary" format. It doesn't suit my needs very well.

However, I have this day job, you know, just like you probably do. And that takes up most of my time. If there's any time left, I'd like to spend some amount of it actually blogging, as opposed to dicking around endlessly with software and configuration just to enable me to blog the way I want to. If I'm going to dick around with coding stuff, I'd rather do something other than that.

But I hate blogs. The format's not right. Chronological ordering of my posts just plain sucks. It forces you to dig around through monthly archives, wondering if there's anything good in all the crap I spew out.

What I want is closer to my own personal Reddit, or Digg, or something like that (but not quite like them, either). I don't want you to come to my site and see what I've posted most recently. RSS can take care of that. I want you to see what other people have voted as my best entries. On my site. You shouldn't have to go to Reddit to get a decent directory of my blog. Anyway, you can't; anything that makes it onto Digg or Reddit or del.icio.us is mixed in with everything else, and gets bumped down into oblivion by stuff that's newer and/or better.

Blog entries should be organized by popularity, not time. Or ideally, you can pick either one. Why the hell don't blogs do that?

But it's got to be even better than that. Having a self-organizing browse interface like Digg's on my blog page would be nice, but I want more.

For instance, I want inline comments. Putting everyone's comments at the end is pretty lame. Even worse, most blog packages these days don't even seem to have Slashdot-style threaded commenting. Instead, the comments are ordered chronologically, just like the entries. So the comment threads are invisible, and commenters have to say stuff like "um, actually I was replying to Dave, not Peter", and quote each other heavily -- a whole subculture of commenter hacks, just to fake threading.

Why the hell don't blogs have threaded comments? Sure, sure, some do. But that's still not enough. Not by a long shot. They need threaded comments and inline comments.

What do I mean by inline comments? I want people to point at a particular sentence I wrote, get all excited or pissed off about it, and say "I want to comment on THIS! This point right here!" So when you're reading, you should get to that part, and see a little icon or link that takes you off to a comment thread on that particularly interesting or disputed section.

In other words, the commentary on a blog entry should grow outward, not downward.

And I want versions. I want to make changes to my entries sometimes -- heck, frequently. But that's culturally weird, and feels dishonest to me, because I've sort-of permanently overwritten the old version. I think people have a right to see how my ideas changed over time, after they yelled at me or made brilliant observations or whatever. So people should be able to see the revision history for individual posts.

It's starting to sound slightly Wiki-like, isn't it? Yeah, a little. But what I want doesn't exist today. It's not a blog, and it's not a wiki, but it's similar to both of them. I want an essay-publishing system, basically.

All that revision-history stuff complicates the commenting, of course; each comment has to keep metadata about which blog revision it was talking about. It's even more complicated if you have versioned comments, so users can go back and fix their typos or change their minds. But it's not like that stuff's impossible, is it? Aren't there companies whose full-time efforts are going into making cool blog software?

Blogs have evolved into the dominant form of self-publishing, and yet nobody's doing it right. To me, that can only mean one of two things, both depressing. Either nobody's been clever enough to figure out an interface that actually works for people who aren't just posting their daily cat picture, or web programming is so insanely hard that nobody's been able to get features out fast enough to keep pace with the ideas.

It's probably a little of both. But my God, if they're hurting for ideas, all they need to do is ask. They're bursting from me; I can't keep them in anymore.

Want some? OK. Here's one: I'm sick of global configuration options. Global config options are so 1970s. When I go into Firefox, I want to be able to override every single configuration option on a per-page basis, or even better, with url pattern-matching rules. Doesn't that seem just patently obvious? And yet there aren't any browsers that let you do that. (Or are there? You tell me. Wouldn't it be nice if you could put an inline comment right here letting me and all the readers know?)

Same goes for my blog software: I want per-post configuration. It seems like I should be able to specify different stylesheet templates for each entry if I want — at least for different categories. Technical posts should have a different stylesheet from the posts about my last vacation.

And I should be able to change the settings for how I'm notified about comments on a per-post basis, because I'll care more about some of them than others.

Isn't all this stuff obvious? How can people not think of this stuff?

Oh, and not to put too fine a point on it, but how about a decent content-editing tool? Blog software packages can't seem to get this simple thing right. You pretty much get simple "convert line breaks" behavior, or you can embed HTML tags and screw with them for hours until you figure out how to make the blog HTML renderer behave the way the exact same tags work in every other page in your browser. If you're lucky. Sometimes it's just impossible, and you have to live with their screwed-up interpretation of the spacing before/after an ordered list or a heading element or whatever.

Can it really be that hard to get this stuff right? O'Reilly's group blogs don't even put a frigging blank line after a heading element, so your first sentence is smooshed right up under the heading.

I'm not asking for WYSIWIG here; I realize that's almost impossible given the amazingly crappy mix of browser technology standards we have to work with today. All I'm asking for is something halfway decent, like you get from any Wiki worth its salt. RedCloth would be my personal preference, but gosh, just about any wiki-style markup language would be preferable to the current choices ("convert line breaks" or "embed HTML tags that don't work properly") that most blog systems give you.

So I've been meaning to set up a public blog for nearly a year, and I haven't done it because all the blog-hosting options are just so wrong. I've been struggling with this whole issue -- not having the right self-publishing software -- and wondering whether to try writing it myself, or to just bite the bullet and live with the crap that's out there today.

I'd recommend just reading the whole post^
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on October 16, 2011, 12:19:40 pm
That is such a good idea that I went ahead and did it. You can now annotate/comment on every paragraph on every page of this tutorial with the click of a button.

(http://img.removedfromgame.com/imgs/ann.png) (http://clrhome.org/tutorials/axe/)

To see the notes and add your own, you must be logged in (http://clrhome.org/members/).
Also, I would be glad if I could contribute to this. I think we should create one big, community-written tutorial.
Personally I think that would be the purpose of the Axe Wiki (http://wiki.axe.omnimaga.org/), not any particular tutorial.
Title: Re: Third-party Axe tutorial
Post by: Juju on October 16, 2011, 12:42:12 pm
Yeah, you should put stuff like tutorials on the Axe Wiki.
Title: Re: Third-party Axe tutorial
Post by: Deep Toaster on October 16, 2011, 12:46:03 pm
Yeah, the tutorials scattered around the forum about some of the more specific topics would make nice articles for the wiki. I'll help move stuff in if you want.