Editing ahx files

Started by csnet, December 23, 2007, 09:52:12 PM

Previous topic - Next topic

Oldtimer

Pierre:

You ask what else you could add to your program.  You've done such a great job so far I hate to ask for anything more but, since you are really skilled with HTML coding, could you add a function that extracts the "Notes" from the AHX file,  strips off the HTML and puts them into a simple TXT file so we'd have them as part of our regular documentation.

The format would be simple.  Just a separate paragraph for each note with the name, house code and unit code for each note at the beginning of the paragraph in whatever order they already are in the note section of the AHX file.

Best,

Oldtimer
Having "fun" with X-10 since 1980.

csnet

Quote from: Oldtimer on January 09, 2008, 04:58:13 PM
...the "Notes" from the AHX file...
I have seen references in other posts to "notes" and "macro notes" in regard to AHP but I have not found anywhere in AHP 3.206 to enter notes.

Are notes an option in another version of AHP or am I missing where they can be entered in AHP 3.206?

Tuicemen

#32
Quote from: csnet on January 09, 2008, 05:26:53 PM
Quote from: Oldtimer on January 09, 2008, 04:58:13 PM
...the "Notes" from the AHX file...
I have seen references in other posts to "notes" and "macro notes" in regard to AHP but I have not found anywhere in AHP 3.206 to enter notes.

Are notes an option in another version of AHP or am I missing where they can be entered in AHP 3.206?
In order to add notes in AHP click:

  • Tools
  • then Preferences
  • Then check the box next to Show module notes!
  • That will bring up the yellow page icon in lower left corner of module icons!
  • Clicking on that will allow you to add notes!
[/color][/b]
Please Read Topic:
General Forum Etiquette
Before you post!

csnet

Thanks Tuiceman, those yellow stickys have been staring me in the face since day 1. 

Now I know they are not just decorations like the opening and closing door.  :)

Tuicemen

#34
I had though there was a link posted for this in my Read Me First thread or Hints & Tips threads but it looks like I missed(forgot) this ! :-[
I'll get it added with a link to this thread! ;)
Please Read Topic:
General Forum Etiquette
Before you post!

PierreP

editahx:
Timers list is a Tuicemen's suggestion
Extract notes is a Oldtimer's suggestion

Thanks guys for those great ideas.

new release again
editahx v1.2: http://pages.infinit.net/pppp/editahx.zip

Oldtimer

#36
Quote from: PierreP on January 09, 2008, 08:17:30 PM
editahx:
Timers list is a Tuicemen's suggestion
Extract notes is a Oldtimer's suggestion

Thanks guys for those great ideas.

new release again
editahx v1.2: http://pages.infinit.net/pppp/editahx.zip


Both work fine!  The "Extract Notes" function is perfect.  Ever since I got AHP when it first came out I've used Notes but have always been frustrated there was no easy way to print them so they could be part of my overall documentation.  Now you've solved that problem and in a matter of hours!  Thank you!

Here are some hints for anyone new to using Notes in AHP.  Entering and editing the Notes requires some care.  If you type in too many characters or do too much editing inside AHP you risk bombing out AHP and losing what you've entered.  The trick is to copy and paste your text to and from Notepad and do all your editing in Notepad.  When you're done save your AHP file before going on to work on the next Note.  This allows you to enter and edit verbose notes.  Also, don't use quotation marks in your Notes.  Your Note text is already inside quotation marks in the AHX file and your additional quotation marks cause the AHP HTML validator to delete some of the text you enter as being invalid.

P.S. See PierreP's post below for other HTML reserved characters that you should avoid in your Notes.
Having "fun" with X-10 since 1980.

steven r

Quote from: PierreP on January 09, 2008, 08:17:30 PM
...Thanks guys for those great ideas....
Thank you for such a great program. Being able to pull out the notes is a great feature.
BVC let's me tell my camera where to go!
:) Murphy is my beta testing pal. He helps me find problems whether I like it or not. :)

PierreP

In XML protocol, 5 signs are reserved

' apostroph
" double quote
< little than
> greater than
& amperstand

We should avoid to use it in module names and notes.
Normally a program knows to deal with, but AHP didn't.
This was the cause of the first error on editahx.

I project to work on module notes editing for editahx. (Oldtimer will be happy)
One information is missing, maximum lenght accepted.
Oldtimer: What is the maximum characters number(approx), you put for one note?

Oldtimer

#39
Quote from: PierreP on January 12, 2008, 02:50:21 PM

I project to work on module notes editing for editahx. (Oldtimer will be happy)
One information is missing, maximum lenght accepted.
Oldtimer: What is the maximum characters number(approx), you put for one note?


PierreP: I checked my Notes print out from your program and my longest note was 1100 characters although I might very well enter a longer one in the future now that your program is available.  Directly editing Notes in your program sounds like a lot of work to implement.  It is an interesting idea though and might be useful to a lot of people.  The problem I see is that it was very natural for me to add the notes to a module inside the context of AHP while I was doing program maintenance , even though I had to use NotePad, but it might not be so nautural to have to exit AHP to work on the notes and then restart AHP to go back and work on the program.
Having "fun" with X-10 since 1980.

PierreP

I understand the Oldtimer's point of view,
but if someone needs to modify notes by editahx, it's now possible.
Create a notes report in HTML is an interesting feature too.

new version 1.3: http://pages.infinit.net/pppp/editahx.zip

steven r

#41
Quote from: PierreP on January 16, 2008, 12:37:10 PM
..new version 1.3...
Wow it just get better & better. I am hoping that you settle on a format soon as I have to figure out the new layout each time.  ;) I do like having the link addresses listed in the about tab.

Now the "bad news". I found a bug. Version 1.3 copied the note comments from one module to another. In my case, one example was a comment I had for H14 also showed up for H5. My H5 doesn't have a comment in AHP.

I'll be glad to send you my ahx file if it will help in the debugging.
BVC let's me tell my camera where to go!
:) Murphy is my beta testing pal. He helps me find problems whether I like it or not. :)

PierreP

Thank you to steven r for his collaboration.

The bug is fixed.

Oldtimer

#43
Quote from: PierreP on January 16, 2008, 09:25:46 PM
Thank you to steven r for his collaboration.

The bug is fixed.

Pierre:

Your program continues to amaze me!  Using it I have now cleaned up my AHX file so it is professionaly organized and documented.  It's really great.  And, yes, I did use your Notes editor in a couple of places.  Came in very handy.  This is really a neat piece of work.

Now, one more thing in the Notes extracts, but only if it's really as straight forward as I think it is.  I believe as you read the file from top to bottom to produce the Notes, you pass the room names on your way.  As you do so could you add them to the extracts with a blank line before and after.  This would make the extracted Notes files much easier to read and understand.  Needless to say this is not a high priority.  What you've given us so far is quite useable.

Thanks very much for your hard, timely and creative efforts.
Having "fun" with X-10 since 1980.

PierreP

Oldtimer:

It's more difficult for me to read and understand english that write program coding.
I have made some changes and I hope that this match your query.
If not, just to tell me and I will be glad to make other changes.

I need to know if you use text format for notes report,
if not, I will eliminate it, and just keep html format.