Hi Matt, hi all, I've read carefully blink a led tutorial, it's highly detailed, covers a lot of things, it's great. I have few minor comments though...:
- in "let's write some code", you say all code is in green... which is not the case in PDF. You should avoid layout & presentation within content, as you can't know which output it'll be (it could be raw text for instance). - when you say to read details on this R0 pin, you say "on the PDF file". It's not clear it's the datasheet (I first thought to read it on my current tutorials.pdf file :)) - in "Write your program", you say "put 2 spaces at the beginning of each line within the loop". It looks like it's mandatory, and putting 0 or 3 spaces won't work. Maybe just an "indent your code for readability" should be enough. Also jallib & JSG prefers 3-spaces indentation. - maybe explain why aliasing pin direction isn't really helpful: we'll set it once, and never reference it again, where "led" will be used multiple time. Cheers, Seb 2009/10/31 mattschinkel <[email protected]> > > looks good seb, I didn't notice the error messages, but I did compile > it ok. I needed to put it in the ditamap file before I could compile > it. > > In the PDF, the "title" blocks look the same as any text that I bold, > Can we have a dif text style, maybe simalar to the website? > > We should decide on a max image width (for consistancy), or have dita > do it for us. Images go out of the page boarder if you don't resize. > > Matt. > > On Oct 31, 5:08 pm, Sebastien Lelong <[email protected]> > wrote: > > Hi Matt, > > > > Your last blink a led version works ok, I've put it on the website: > > > > http://justanotherlanguage.org/content/tutorial_blink_a_led > > > > Just FYI, when compiling it, I got the following error message, output is > > still produced however: > > > > [xslt] [DOTX006E][ERROR]: Unknown file extension in href: ' > http://www.casadeyork.com/jalv2/language.html'. If this is a link to a > > non-DITA resource, set the format attribute to match the resource (for > > example, 'txt', 'pdf', or 'html'). If it's a link to a DITA resource, the > > file extension must be 'dita' or 'xml'. Set the format attribute and > specify > > the format of the file if href link doesn't point to dita topic file. > > Otherwise, change the file extension name to 'dita' or 'xml'.The location > of > > this problem was at (File = > > > /home/sirloon/Documents/Projects/jallib/doc/dita/tutorials/tutorial_blink_a_led.xml, > > Element = xref:1) > > > > Basically, you need to add format="html" to this xref element. > > > > Also, I've recently written few XSL customization about making image > > clickable (justt like jalliblog): when you click on it, it opens a new > > window, with image in full size. This is useful for diagrams for > instance. > > The syntax is: > > > > <image href="..." widht="XXX" otherprops="clickable"/> > > > > I've fixed xref and made few images clickable, so you can have a look. > > This is the kind of things that should be put in a DITA tutorial... > > > > Cheers, > > Seb > > > > 2009/10/31 Sebastien Lelong <[email protected]> > > > > > > > > > > > > > > > > >> also, can you put my tutorial_blink_a_led.xml into the main ditamap. > > >> i'm not sure what topic you want it under. > > > > > I have problems to compile it, some images are missing. It seems it > doesn't > > > support BMP images. BMP images are not a good choice any way as it > gives > > > very big files (uncompressed), not suitable for web publishing. Could > you > > > convert them to JPG (for photos) or PNG (diagrams) or something like > that ? > > > > > Cheers, > > > Seb > > > > >> On Oct 30, 12:58 am, mattschinkel <[email protected]> wrote: > > >> > Seb, I noticed serial_hw lib has a serial_hw_write_word() procedure. > > >> > Can we ad a serial_hw_write_dword() procedure? > > > > >> > and I suppose these 2 procedures should be in the software version > as > > >> > well? > > > > >> > Thanks, > > >> > Matt. > > > > > -- > > > Sébastien Lelong > > >http://www.sirloon.net > > >http://sirbot.org > > > > -- > > Sébastien Lelonghttp://www.sirloon.nethttp://sirbot.org- Hide quoted text > - > > > > - Show quoted text - > > > -- Sébastien Lelong http://www.sirloon.net http://sirbot.org --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "jallib" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/jallib?hl=en -~----------~----~----~----~------~----~------~--~---
