Ultimate Amiga

Please login or register.

Login with username, password and session length
Advanced search  
Pages: 1 [2] 3 4 ... 9   Go Down

Author Topic: AMOS Manuals / AMOS Pro Resource Kit Project  (Read 46308 times)

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #15 on: December 05, 2011, 09:24:05 AM »

OpenOffice Strikes again: I Don't Be-lieeeeve It. LOL.

There is a bug in OpenOffice (At Least it I think it's a bug).

When you crate hyperlinks for the TOC, OpenOffice automatically crates bookmark entries for those links in the form of "_RefHeading_2937_19063537071", these are hidden bookmarks and are not displayed in the Navigator panel. However when you attempt set the hyperlink target to a document bookmark the Target Document Dialog does display them.

You can imagine the frustration when attempting to locate the bookmark you want to link to and it's nested amongst 250+ of these entries :o.
The good news is with a little bit of research I have put together some macro code that can delete the bookmarks. I'm in the process of linking this to a dialog so that only the unwanted bookmarks are deleted.

Please excuse some maniacal laughter  :) :) :D :D ;D ;D ;D :) :D ;D ;D
All better now, we persevere because we can.
Logged
My shadow says otherwise.

BooBoo

  • Amiga Guru
  • A600
  • ****
  • Karma: 3
  • Offline Offline
  • Posts: 168
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #16 on: December 06, 2011, 09:46:16 AM »

Well Done Dude great progress  :)
Logged

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #17 on: December 11, 2011, 06:42:02 PM »

Update: Releases.

Well finally, After 900+ manually created bookmarks and 900+ manually created links later :o, It's done. ;D

The following manuals are available in the Documentation download section.
AMOS 3d QuickCard, PDF
AMOS The Creator User Guide, OpenOffice ODT
AMOS The Creator User Guide, PDF

I have also uploaded the AMOS 3d User Guide to the Documentation download section (No changes same as previous upload).
AMOS 3d User Guide, OpenOffice ODT
AMOS 3d User Guide, PDF

Ironically, after I got the macro code debugged, tested and working, I was about to use it on the AMOS The Creator User Guide when I found an easier and faster way to set the bookmark links, go figure ???. It was fun to do anyway and I'll use it at some point.
« Last Edit: February 03, 2012, 07:34:50 AM by MadAngus »
Logged
My shadow says otherwise.

Hungry Horace

  • Amorphous Blue-Blob Man
  • Site Admin
  • A4000T
  • ******
  • Karma: 306
  • Offline Offline
  • Posts: 3,329
  • Don't forget... Ameboid's need love too!
    • Amiga Online
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #18 on: December 13, 2011, 11:35:00 AM »

Amiga Game Maker's Manual, Stephen Hill - OnHold
Ultimate AMOS, Jason Holburn - OnHold

right now, i'm gutted that you've put these on-hold, as I have both and I am not at home, so i would love to have a look at some stuff in them!!
Logged
Quote from: KillerGorilla
because winuae is made of code and your amiga is made of stuff

Hungry Horace's Artwork Available
Buy my work

http://twitter.com/horaceandspider

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #19 on: December 17, 2011, 07:11:13 PM »

Hungry Horace:
Sorry mate, had to, the Mandarin/Europress manuals are 1st priority as they are the foundations of my other project.

Craft Manual:
Permission from Richard M Holmes, whom I believe is now running www.clubv3.com, was requested on the 12/12/2011.
No response as yet, keeping fingers crossed.
Logged
My shadow says otherwise.

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #20 on: December 29, 2011, 06:17:05 PM »

Yippee! more AMOS stuff arrived.

Just received some AMOS docs.

AMOS Pro Application Supplement and
10 Issues of AMOS Club Newsletter

I'll be Adding these to the AMOS Manuals project.

The news Letter Issues are
Issue 0 - 8 Pages
Issue 1 - 20 Pages
Issue 2 - 20 Pages
Issue 3 - 20 Pages
Issue 4 - 20 Pages
Issue 5/6 Double Issue - 36 Pages
Vol 2 .Issue 1 - 20 Pages
Vol 2 .Issue 2 - 20 Pages
Vol 2 .Issue 3 - 20 Pages
Vol 2 .Issue 4 - 20 Pages
Logged
My shadow says otherwise.

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #21 on: December 30, 2011, 07:32:41 AM »

Update: Releases and change of plan.

The following manuals are now available in the Documentation download section.
AMOS Compiler User Guide, PDF
AMOS Compiler User Guide, OpenOffice ODT
AMOS-Pro Compiler User Guide, PDF
AMOS-Pro Compiler User Guide, OpenOffice ODT

As for the change of plan:
I have decided to focus entirely on the Mandarin/Europress documentation as there is a lot I wish do due with these beyond converting them to digital documents. I also intend to write some of my own material and release it as part of this project.

Therefore, with immediate effect, the following will not be converted and will be removed from the project plan.

Amiga Game Maker's Manual, Stephen Hill
Ultimate AMOS, Jason Holburn
CRAFT for AMOS

Note: If permission is ever received for CRAFT for AMOS then I will add this back into the project. However, please assume that this will not happen.

The project plan will be updated to reflect these changes.
« Last Edit: December 30, 2011, 11:46:01 PM by MadAngus »
Logged
My shadow says otherwise.

BooBoo

  • Amiga Guru
  • A600
  • ****
  • Karma: 3
  • Offline Offline
  • Posts: 168
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #22 on: January 05, 2012, 09:58:06 AM »

Is there any chance of getting what youve already done of Craft?
Logged

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #23 on: January 06, 2012, 01:43:15 AM »

Sorry BooBoo, there are a couple of reasons why I can't do what you ask.

Firstly, It's important for this manual project and project Avolution to not to be involved in distributing copyrighted material without permission. These project's rely on François Lionet/clickteam's permission for distribution. I would not want to risk François Lionet distancing himself from the project's and removing his permission as he has the legal right to do so.

Secondly, I was hoping that when project Avolution matures that Richard Holmes would hear about it and decided to donate his software for integration. I'll concede that this is a few years away and doesn't help much.

There is one good thing about Craft and that is it was, and still is, a popular extension to AMOS, judging by the frequency I see original copies pop up on AmiBAy and eBay. Generaly you can get an original boxed copy with manual for around £10. If you were to put a wanted add on AmiBay, I'm sure someone would offer their's for sale.
« Last Edit: December 08, 2012, 10:21:57 AM by MadAngus »
Logged
My shadow says otherwise.

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #24 on: January 12, 2012, 12:52:50 PM »

AMOS manuals page numbering.

Due to the way I'm reworking the AMOS manuals the page numbering is out of skew with the original manuals. I'm not going to change this but was thinking of adding extra page number entries in the index's and possibly the TOC to help those with printed manuals. It's not that much work as these extra page numbers wouldn't need any links created.

Even though I'll be adding index's to all manuals in the rev2 releases, they will still be out of skew with the printed manuals. Also, not all manuals have an index so you can't simply look up the manual's original index.

An example of the skew is shown below for the AMOS The Creator Manuals.

My numbering:
AMAL
--Channels 188, 207-209

Original numbering:
AMAL
--Channels 179, 197-199

Now the question is how would I display these extra page numbers in a way that wouldn't be too confusing.

Initial idea was to just do something like this:
AMAL
--Channels 188 (179), 207-209 (197-199)

An alternative method would be to provide a lookup table for all pages out of skew.

[Edit]
Page numbering and content will be fixed in the second revision.
« Last Edit: February 03, 2012, 07:36:48 AM by MadAngus »
Logged
My shadow says otherwise.

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #25 on: January 30, 2012, 02:27:17 AM »

Update: Releases:

The following manuals are available in the Documentation download section.

AMOS-Pro Application Supplement, OpenOffice ODT
AMOS-Pro Application Supplement, PDF

Temporary Upload:
In addition, for those that would like a good read (and just can't wait) I have uploaded all issues of the AMOS Club Newsletters Volume 1 and 2 in JPG format. Once I have completed and uploaded the ODT and PDF conversions I will remove these. 

AMOS Club Newsletters Volume 1 (PDF) - > (Has been released, see download section)

AMOS Club Newsletters Volume 2 (PDF) - > (Has been released, see download section)
« Last Edit: January 24, 2013, 09:02:06 AM by MadAngus »
Logged
My shadow says otherwise.

bruceuncle

  • AMOS Dev
  • A500
  • *****
  • Karma: 6
  • Offline Offline
  • Posts: 425
  • WINUAE Amiga User
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #26 on: February 06, 2012, 04:39:36 AM »

Hi MadAngus.  I hadn't realised how many toes I was crunching when I started out to just add bookmarks and a few notes to the AMOS Pro PDF Manual.  It's the one credited to asymetrix. 

I'd like to post it anyway, if possible, as a stop-gap available now.

I'll keep everyone posted on the quick-reference guides.  The Interface Language one is just about complete - I'm just dithering over the seqence to present them in and need to add the extra syntax versions noted here http://www.ultimateamiga.co.uk/index.php/topic,9096.0.html.  Either alphabetical (most useful when reading existing code) or functional (most useful when actually writing the wretched stuff!).  As it only comes to three to four pages, I'll probably do both.

Great work mate.  Bonza effort.  (Well, we Aussies have another language to keep alive :) !)
Logged
Repeat after me ...  "The AMOS Pro architecture is complex but it is not complicated."

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #27 on: February 06, 2012, 08:53:14 AM »

Thanks mate,

I wear steel toe-capped boots, so my toes are invulnerable.

Your modifications to the PDF manual could be uploaded as "AMOS Pro User's guide (PDF Bookmarked Version)", does that sound OK to you?
Logged
My shadow says otherwise.

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #28 on: February 08, 2012, 03:28:12 AM »

[Updates and Releases]

bruceuncle has provided us with a bookmarked version of the AMOS Pro User's Guide (PDF), originally released by asymetrx.
bruceuncle has also provided a quick-reference for the AMOS Pro Interface Language (AMOS Interface Command Summary V1.00.zip)

These are now available in the downloads section. Big thank you to bruceuncle for his work.

In addition I am providing mini cover images of the manuals in 3 sets with different sizes (preview and file attached below):

Equal Height
Equal Width
Equal Height and Width
Also included is the PDF,ODT and HTML overlays I use.

HungryHorace, if you would like any of the images cleaned up let me know.

Preview (Equal Height and Width 150h x 125w)
« Last Edit: February 08, 2012, 03:39:54 AM by MadAngus »
Logged
My shadow says otherwise.

MadAngus

  • There is no spoon.
  • Site Admin
  • A500
  • ****
  • Karma: 5
  • Offline Offline
  • Posts: 497
  • AMOS Docs / AIAB Dev
    • AIAB (Amiga In A Box)
Re: AMOS Manuals / AMOS Pro Resource Kit Project
« Reply #29 on: February 09, 2012, 07:05:50 PM »

Myself and bruceuncle have been discussing the AMOS manuals project over private message the next three posts is the content of that discussion.

Post 1
Source: MadAngus

Manuals Management:
I've updated the AMOS Manuals page with a summary of the project goals to make it a bit clearer where I want to take this project.

The manuals should be released using the same structure and styles. This will probably mean that the documents you release will eventually be re-worked to correspond with the standard structure and styles I've set up in OpenOffice. It will also make it easier to generate HTML versions.

I should note, I'm not claiming some over-lordship to these manuals, the more input the better, I just want to make sure there aren't twenty different formats/styles the end user has to contend with.

AMOS Pro PDF Manual:
Great, go ahead and do your version with bookmarks and notes. I'm currently working on the AMOS Pro Manual to add bookmarks and linked Contents/Indexes, I'll eventually collate the data you provide into one manual. Which gives me the idea of a wiki style markup document so others can do the same. That would be for the long term though.

Uploads:
Email me the updated AMOS Pro Manual and The AMOS Interface Language Quick Reference Guide I'll upload them to the documentation download section for you.

If you have any ideas or opinions about the Manuals Project fire them across.

Quote
Bonza effort.  (Well, we Aussies have another language to keep alive :) !)

I get that I'm a Glaswegian from The Scotland.  ;)
« Last Edit: February 09, 2012, 07:20:05 PM by MadAngus »
Logged
My shadow says otherwise.
Pages: 1 [2] 3 4 ... 9   Go Up
 

TinyPortal 1.6.4 © 2005-2019