Jump to content

Sky Slate Blueberry Blackcurrant Watermelon Strawberry Orange Banana Apple Emerald Chocolate
Photo

ahkbook - a free online book for AutoHotkey


  • Please log in to reply
115 replies to this topic
Frankie
  • Members
  • 2930 posts
  • Last active: Feb 05 2015 02:49 PM
  • Joined: 02 Nov 2008
The way I understand it is non-commercial means Microsoft can't take content from the book and start charging people money to see it. These things can be waived by the author in many cases to, for example, let someone publish a paper copy of this book.

Share-alike means that someone can't take text from ahkbook, modify it, and then release it under a completely different license. I think it compliments the NC rule.

btw: still no answer from github support :? Either they forgot, or it takes some time to fix it.

They're 1 version behind on their Jekyll. You can download each of the tags and compare the Pygments versions they use to see if it's been fixed in more recent versions; if not you can probably discover why.
aboutscriptappsscripts
Request Video Tutorials Here or View Current Tutorials on YouTube
Any code ⇈ above ⇈ requires AutoHotkey_L to run

maul.esel
  • Members
  • 790 posts
  • Last active: Jan 05 2013 09:26 PM
  • Joined: 28 Feb 2011

Why begin with a coding environment? Why do you tell the fresh user about things like GuiCreator or TillGoto? Just tell him that any editor will do fine with the first scripts and do not scare him. It looks complicated, what AHK is NOT.

Valid point. I'll move it to a later point. And maybe split it (GuiCreator when Gui comes in, TillaGoto with labels, ...)

And then, on that first script topic, you describe the escape sequences. This would scare any non programmer and is very uninteresting. Such topics like escape sequences should be handled later, if more deep knowledge is needed.

True, but where to put them? Should I also move comments?

And then, the new user should not be bugged with many theory. Do not confuse the beginner with all possible things in that language. Just start with hotkeys. Explain in small steps between the lessons. It is too logically based sorted.

Damn, I spent so much time in making it logically. :evil: But you're right, that part could be split. :)

And text-align:justify makes too big spaces around the words. I do not like that look and makes reading it harder. A regular left aligned text would be better (for me and I think for most readers).

Do you think? Actually, it was left-aligned and I made it justified in the latest commits because I prefer it. I'll reconsider though.

These things can be waived by the author in many cases to, for example, let someone publish a paper copy of this book.

I'm sorry, I do not fully understand that sentence. :( Could you explain your point again?

They're 1 version behind on their Jekyll.

Sure? Because Github Pages docs say they use 0.11.0 - which is the latest tag in the jekyll repo. The strange thing is that in my Ubuntu VM, syntax shows up and is correctly highlighted. And I'm also using 0.11.0. And other languages (e.g. C#) work on github, too.

Btw, is there a way to prevent the line numbers (in code boxes) from being selected?
Edit: done.
Join the discussion on The future of AutoHotkey
Posted Image Visit me on github Posted Image
Win7 HP SP1 64bit | AHK_L U 64bit

nimda
  • Members
  • 4368 posts
  • Last active: Aug 09 2015 02:36 AM
  • Joined: 26 Dec 2010
Frankie means that it's illegal to charge for the content of ahkbook without copyright owner's consent. Obviously a paper book has to be charged for, so the publisher would need your permission to sell a paper copy.

maul.esel
  • Members
  • 790 posts
  • Last active: Jan 05 2013 09:26 PM
  • Joined: 28 Feb 2011
Ah, thanks for that explanation. But wouldn't this even require Frankie's (and all other contributors') permission?
This might be very difficult or even impossible - which would be a problem.

Btw: Frankie, the code blocks look really awesome! Great!

Edit: Anyone suggesting a good icon for the site?
Join the discussion on The future of AutoHotkey
Posted Image Visit me on github Posted Image
Win7 HP SP1 64bit | AHK_L U 64bit

AaronsWorld
  • Members
  • 23 posts
  • Last active: Dec 10 2012 09:55 PM
  • Joined: 20 Jul 2011
Well I like the book so far, reading the first couple of pages and saw that there is example code missing or I cant see it.

Posted Image

from: <!-- m -->http://maul-esel.git... ... cript.html<!-- m -->

tried IE and firefox...

Grendahl
  • Members
  • 416 posts
  • Last active: Jul 07 2014 08:01 PM
  • Joined: 10 Aug 2009
I have the exact same error in Chrome. No example code.


In the editor, type the following code:
Save your file again now.


Always have your scripts when you need them with Dropbox.
Sign up for free! http://db.tt/9Hrieqj

Frankie
  • Members
  • 2930 posts
  • Last active: Feb 05 2015 02:49 PM
  • Joined: 02 Nov 2008
It's a known issue. For some reason Pygments won't render AutoHotkey code on GitHub-Pages. We've been discussing it on and off for the past few pages.
aboutscriptappsscripts
Request Video Tutorials Here or View Current Tutorials on YouTube
Any code ⇈ above ⇈ requires AutoHotkey_L to run

AaronsWorld
  • Members
  • 23 posts
  • Last active: Dec 10 2012 09:55 PM
  • Joined: 20 Jul 2011

It's a known issue. For some reason Pygments won't render AutoHotkey code on GitHub-Pages. We've been discussing it on and off for the past few pages.


ahh thanks! I saw the pygments discussion but hat no idea wtf that was...
any way we can see the code another way?... link to html, txt, forum post, or pic or something?

Makes it harder to follow without the code ;)

maul.esel
  • Members
  • 790 posts
  • Last active: Jan 05 2013 09:26 PM
  • Joined: 28 Feb 2011
We're lucky. I just got an answer from support. github is using pygments 1.3.1 for github pages now, AHK is supported since v1.4. They will upgrade soon.

@AaronsWorld: I'm glad you like it :D
Join the discussion on The future of AutoHotkey
Posted Image Visit me on github Posted Image
Win7 HP SP1 64bit | AHK_L U 64bit

maul.esel
  • Members
  • 790 posts
  • Last active: Jan 05 2013 09:26 PM
  • Joined: 28 Feb 2011
Helpers & co-workers needed!

Help! This is way to much for me alone! Help me!
[*:h1qgtq22]Regex masterminds: write the RegEx-part :!:
[*:h1qgtq22]Hotkey experts & gamers: contribute to the hotkey & hotstring part :!:
[*:h1qgtq22]GUI professionals: help beginners to understand AHK GUIs :!:
[*:h1qgtq22]library creators & users: present the most common & useful libs (e.g COM, gdip, CGui, Aero, ...) :!:
[*:h1qgtq22]COM automators: show how to automate IE and Office :!:
[*:h1qgtq22]Memory specialists: add info on NumPut, -Get, VarSetCap. :!:
[*:h1qgtq22](ex-)noobs: explain the basic AHK actions and the problems you had :!:
[*:h1qgtq22]OOP-programmers: introduce AHK's objects, arrays, classes :!:
[*:h1qgtq22]Perfectionists: Do constructive criticism and nit-picking :!:
[*:h1qgtq22]... and a lot more:!:Regards
maul.esel

P.S.: Thanks to Frankie, nimda and Uberi, who have already helped a lot, and Tuncay, whose suggestions were really useful.
P.P.S.: Seems we'll have to wait a bit more for code to work on github?
Join the discussion on The future of AutoHotkey
Posted Image Visit me on github Posted Image
Win7 HP SP1 64bit | AHK_L U 64bit

Tuncay
  • Members
  • 1945 posts
  • Last active: Feb 08 2015 03:49 PM
  • Joined: 07 Nov 2006
I have an project in early stage, a RegEx Tutorial for AHK as a soft introduction. So you can see I have an interest in that part.^^ If I have some time, I would like to contribute to that regex part.

:arrow: Dive into Regular Expression (an early uncomplete working draft)

No signature.


  • Guests
  • Last active:
  • Joined: --
No need to replicate / duplicate information in the book if there are already good intros on the forum like jethrow's com <!-- m -->http://www.autohotke...topic51020.html<!-- m --> I believe there is a regex tut somewhere as well etc.

Tuncay
  • Members
  • 1945 posts
  • Last active: Feb 08 2015 03:49 PM
  • Joined: 07 Nov 2006
@Guest
True, there are some regex tutorials out there for AHK. But I never saw a tutorial which I liked myself. I would like do it my way, a more carefully entrance. It is not just a dublication of already known information, just another way to teach.

You surely mean the Tutorial: An AHK Introduction to RegEx by sinkfaze

No signature.


  • Guests
  • Last active:
  • Joined: --
Yes, that was the one. I was typing while you posted so didn't see your post, so just a coincidence I mentioned regex as it was just an example.
The same goes for libs. Many are documented already in the thread or have their own doc pages, why copy that into the book? That would be too much work, and what is useful for one persion is useless for another. Short intros would be useful if ahk at somepoint would get real stdlibs which are included in the ahk install like AutoIt UDFs. For now a link to your stdlib collection thread will be a good starting point for many, if they get that far into the book they should visit the forum ;-)

maul.esel
  • Members
  • 790 posts
  • Last active: Jan 05 2013 09:26 PM
  • Joined: 28 Feb 2011
@Tuncay: Looks good :shock: Would be happy if you could contribute some wisdom. :)

@Guest:
Well, the purpose of this book is (among others) to collect information. Of course, simply replicating lib documentation would be not very useful. Instead, it's more meant to be a reference to those (commonly used) libs + maybe a little example.
Also, for example, I myself couldn't find an explanation what a "device context" etc. is (gdip).
Join the discussion on The future of AutoHotkey
Posted Image Visit me on github Posted Image
Win7 HP SP1 64bit | AHK_L U 64bit