Hi,

>
> http://justanotherlanguage.org/content/building-max232-circuit-pic-serial-port-communication
>
> I'm still not sure how to put it in the book, I will when I get more
> knowlege of dita.
>


Great ! As this is not a tutorial explaining jallib libraries, maybe this
kind of documentation could go in a dedicated chapter or appendix:
"Materials", explaining basic tools & parts absolutely needed for tutorials.
Serial communications section would explain possibilities, including this
one.

As for DITA, I would wait some more until a final decision, to avoid waste
of time (I agree to waste my time on this tutorial book, it's also to show
& test DITA). If you're ready to potentially waste your time :) :

  - use Serna editor (and maybe have a quick look at their tutorial, but
that's easy IMO)
  - create a new "topic" document, DITA version 1.0 (not 1.1)
  - or, better, copy tutorial_pwm1.xml for instance, as a start/template
  - put your title, add "prolog" where you put your name,
  - use "section", "p", ... to put your content.
  - "image" has interesting attributes:
      - "width" : image should be larger than 400 (or won't fit on PDF)
      - "placement" : ="break" will put content under the image, ="inline"
and content will follow image.
  - if you use "xref" to create link that is not pointing to a DITA file,
your need to specify attribute "format" (="html", ="jal", ...), to tell DITA
it's not a DITA file.

Serna has a "publish" feature, that create HTML or PDF on the fly, using an
embedded DITA Toolkit (version 1.4, whereas I use last 1.5, but it works).
You'll probably have to adjust your JAVA_HOME env. var.

Once done, you can put it in a ditamap, where it's assembled. See
tutorials.ditamap, and "topicref" element. When you're at this state, I can
put it in ditamap if you want.


Cheers,
Seb

--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to