[Framers] Reading Application Definitions (was Re: Another Simple Structured App)

[Lynne A. Price]

C2,

   I wonder if you edited the application definition but did not 
process the change. The modification won't be processed until you 
restart FrameMaker (if you are using your default application definition 
file) or until you use Structure > Application Definition > Read 
Application Definitions.


    --Lynne


On 4/6/2022 2:58 PM, cuc tu wrote:

What's next? Define this app in structapps.fm and just fill in the non-existant 
dtd file name and try again? Even doing that FM says my app does not exist. 
Seems I need a DTD to make an app, but I need an app to make a DTD.



On 4/6/2022 3:17 PM, cuc tu wrote:

Quick follow-up to the last part of my email - for whatever reason, closing FM 
and reopening my EDD allowed me to then save it as a DTD. Maybe I'm down to 
just formatting and pulling in other element data.


--
Lynne A. Price
Text Structure Consulting, Inc.
Specializing in structured FrameMaker consulting, application development, and 
training
lpr...@txstruct.comhttp://www.txstruct.com
voice/fax: (510) 583-1505  cell phone: (510) 421-2284

___

This message is from the Framers mailing list

Send messages to framers@lists.frameusers.com
Visit the list's homepage at  http://www.frameusers.com
Archives located at http://www.mail-archive.com/framers%40lists.frameusers.com/
Subscribe and unsubscribe at 
http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
Send administrative questions to listad...@frameusers.com

[Framers] DTDs and EDDs (was Re: Another Simple Structured App)

[Lynne A. Price]

C2,

   XML documents do not require DTDs unless attributes have default 
values or the documents use entities. (Note: FrameMaker uses entities to 
represent a book in XML.) FrameMaker can create an EDD from a DTD or a 
DTD from an EDD. The former is useful if your starting point is XML that 
uses a DTD; the latter is useful if you have an EDD and want to create a 
DTD.


  A structured application specifies the pieces you need to work with 
XML (or SGML). Such pieces can include an EDD, a template, XSLT 
transforms, and read/write rules. You may be able to create a DTD before 
you define a structured application, selecting  in the 
pop-up menu in the Use Structured Application dialog box that the 
Structure > DTD > Save as DTD command brings up.


    --Lynne

On 4/6/2022 2:58 PM, cuc tu wrote:

... I'm stuck with creating the DTD. I follow the instructions here to make the 
EDD and then the next section is to create the DTD, but FrameMaker complains 
there is not structured App. This feels like a chicken and egg issue.


--
Lynne A. Price
Text Structure Consulting, Inc.
Specializing in structured FrameMaker consulting, application development, and 
training
lpr...@txstruct.comhttp://www.txstruct.com
voice/fax: (510) 583-1505  cell phone: (510) 421-2284

___

This message is from the Framers mailing list

Send messages to framers@lists.frameusers.com
Visit the list's homepage at  http://www.frameusers.com
Archives located at http://www.mail-archive.com/framers%40lists.frameusers.com/
Subscribe and unsubscribe at 
http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
Send administrative questions to listad...@frameusers.com

[Framers] Displaying multiple attribute values in different paragraphs (Re: Another Simple Structured App)

[Lynne A. Price]

C2,

  I plan on answering some of your questions in a series of different 
messages. Here's the first one:


On 4/6/2022 2:58 PM, cuc tu wrote:

So I need to figure out how to get the formatting to work. It seems I can 
sometimes pick to use a para format, but the attributes do not allow different 
paragraphs for different attributes in the same element. I've tried the 
formatting as shown here and also in the Prefix/Suffix rules.


   XSLT can help you display different attributes in different 
paragraphs with different formats. If you are given an XML document that 
contains:




  


  


  
  

  

   XSLT can create a new related XML document in which you change the 
attributes to subelements. Your ScpiCommand element would then start with


LaunchSetupType
  Launch Setup Type
  Sets the launch setup type. Outputs the launch setup 
type.

   and continue with new elements for the remaining attributes and then 
the original content for the elements. This variation of the original 
document would be a temporary file that is never saved. Your XML 
application would specify using XSLT and when you open the provided XML 
document, FrameMaker would run XSLT to create the temporary file and 
then open the result to create a structured document that uses 
subelements instead of attributes. Doing so would allow you to use 
different paragraph formats for different original attribute values.


Your EDD would reflect the modified structure (with subelements instead 
of attributes).


    --Lynne

--
Lynne A. Price
Text Structure Consulting, Inc.
Specializing in structured FrameMaker consulting, application development, and 
training
lpr...@txstruct.comhttp://www.txstruct.com
voice/fax: (510) 583-1505  cell phone: (510) 421-2284

___

This message is from the Framers mailing list

Send messages to framers@lists.frameusers.com
Visit the list's homepage at  http://www.frameusers.com
Archives located at http://www.mail-archive.com/framers%40lists.frameusers.com/
Subscribe and unsubscribe at 
http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
Send administrative questions to listad...@frameusers.com

Re: [Framers] Another Simple Structured App

[cuc tu]

Quick follow-up to the last part of my email - for whatever reason, closing FM 
and reopening my EDD allowed me to then save it as a DTD. Maybe I'm down to 
just formatting and pulling in other element data.

Thanks
C2

From: cuc tu 
Sent: Wednesday, April 6, 2022 2:58 PM
To: framers@lists.frameusers.com 
Subject: Re: Another Simple Structured App

Hi All,

Sorry, I've been remiss on this topic I've started, but I have been looking 
when I can (too many things going on).

I have built the EDD and have imported it to a sample source XML file, and have 
resolved all validation errors. Now I have a wall of attribute text to parse 
out.

Maybe if we look at how to define this one element:



  


  


  
  

  

OK, there are several elements there, but here is what I did for the parent 
element:

Element (Container):  ScpiCommand
General rule: 
Suffixes
Attribute list
Name: ClassName String Optional
Name: ClassLongName String Optional
Name: ClassDescription String Optional
Name: String String Optional
Name: Overlapping String Optional
Name: Lockable String Optional
Name: Type String Optional
Text format rules
If context is: [Attribute=”String”]
Use paragraph format: SCPICommand
If context is: [Attribute=”ClassDescription”]
Use paragraph format: Indented
Prefix rules
In all contexts.
Prefix: <$attribute[String]><$attribute[ClassDescription]>


Here is what I am getting out (in FM body):

SYSTem:LAUNch:TYPESets the launch setup type. Outputs the launch setup type.
LaunchSetupTypeEnumLaunch setup type to be set
LaunchSetupTypeEnumLaunch setup type to be read
Example: SYST:LAUN:TYPE LASTSets the launch setup type to Last.
Example: SYST:LAUN:TYPE?Outputs the launch setup type.

So I need to figure out how to get the formatting to work. It seems I can 
sometimes pick to use a para format, but the attributes do not allow different 
paragraphs for different attributes in the same element. I've tried the 
formatting as shown here and also in the Prefix/Suffix rules.

Or character format everything and figure out how to add line breaks between 
certain attributes or characters around them. Also, the  attribute 
Enum="LaunchSetup" should pull information from the correct  element 
rather than use the value of the attribute there.



  
  
  

  


Maybe something like below would be presentable. The second command query form 
must be generated when the  attribute Type="Both"; otherwise we 
print just the command or query if there are not complemenatry forms.

SYSTem:LAUNch:TYPE
Sets the launch setup type.
SYSTem:LAUNch:TYPE?
Outputs the launch setup type.

Parameter Type: Enum
Parameters: DEF, LAST, SAV (DEFAULT, LAST, SAVED)

Example: SYST:LAUN:TYPE LAST
Sets the launch setup type to Last.

Example: SYST:LAUN:TYPE?
Outputs the launch setup type.


Finally, I'm stuck with creating the DTD. I follow the instructions here to 
make the EDD and then the next section is to create the DTD, but FrameMaker 
complains there is not structured App. This feels like a chicken and egg issue.

https://help.adobe.com/en_US/framemaker/using/index.html#t=using-framemaker%2Fuser-guide%2FWS37D3BBAC-A1FA-4fe3-9217-84364402A9D9_ver12.0.html
On this page, Step 2? Why are we doing that? Isn't that already done?
Step 5 presents a dialog that says "myapplication" does not exist, but also to 
reset the application name or define a new one... Where how is that described?
Oh, I had a wild crazy idea, when setting the structured app, rather than 
picking one from the list, go black-hat rogue and randomly type something in. 
Who'd a thought? Oh, that doesn't work either.

What's next? Define this app in structapps.fm and just fill in the non-existant 
dtd file name and try again? Even doing that FM says my app does not exist. 
Seems I need a DTD to make an app, but I need an app to make a DTD.

Sorry I'm rambling now.

C2
Adobe 
FrameMaker
The complete Adobe FrameMaker (2020 release) Online User Guide (Online Help)
help.adobe.com

___

This message is from the Framers mailing list

Send messages to framers@lists.frameusers.com
Visit the list's homepage at  http://www.frameusers.com
Archives located at http://www.mail-archive.com/framers%40lists.frameusers.com/
Subscribe and unsubscribe at 
http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
Send administrative questions to listad...@frameusers.com

Re: [Framers] Another Simple Structured App

[cuc tu]

Hi All,

Sorry, I've been remiss on this topic I've started, but I have been looking 
when I can (too many things going on).

I have built the EDD and have imported it to a sample source XML file, and have 
resolved all validation errors. Now I have a wall of attribute text to parse 
out.

Maybe if we look at how to define this one element:



  


  


  
  

  

OK, there are several elements there, but here is what I did for the parent 
element:

Element (Container):  ScpiCommand
General rule: 
Suffixes
Attribute list
Name: ClassName String Optional
Name: ClassLongName String Optional
Name: ClassDescription String Optional
Name: String String Optional
Name: Overlapping String Optional
Name: Lockable String Optional
Name: Type String Optional
Text format rules
If context is: [Attribute=”String”]
Use paragraph format: SCPICommand
If context is: [Attribute=”ClassDescription”]
Use paragraph format: Indented
Prefix rules
In all contexts.
Prefix: <$attribute[String]><$attribute[ClassDescription]>


Here is what I am getting out (in FM body):

SYSTem:LAUNch:TYPESets the launch setup type. Outputs the launch setup type.
LaunchSetupTypeEnumLaunch setup type to be set
LaunchSetupTypeEnumLaunch setup type to be read
Example: SYST:LAUN:TYPE LASTSets the launch setup type to Last.
Example: SYST:LAUN:TYPE?Outputs the launch setup type.

So I need to figure out how to get the formatting to work. It seems I can 
sometimes pick to use a para format, but the attributes do not allow different 
paragraphs for different attributes in the same element. I've tried the 
formatting as shown here and also in the Prefix/Suffix rules.

Or character format everything and figure out how to add line breaks between 
certain attributes or characters around them. Also, the  attribute 
Enum="LaunchSetup" should pull information from the correct  element 
rather than use the value of the attribute there.



  
  
  

  


Maybe something like below would be presentable. The second command query form 
must be generated when the  attribute Type="Both"; otherwise we 
print just the command or query if there are not complemenatry forms.

SYSTem:LAUNch:TYPE
Sets the launch setup type.
SYSTem:LAUNch:TYPE?
Outputs the launch setup type.

Parameter Type: Enum
Parameters: DEF, LAST, SAV (DEFAULT, LAST, SAVED)

Example: SYST:LAUN:TYPE LAST
Sets the launch setup type to Last.

Example: SYST:LAUN:TYPE?
Outputs the launch setup type.


Finally, I'm stuck with creating the DTD. I follow the instructions here to 
make the EDD and then the next section is to create the DTD, but FrameMaker 
complains there is not structured App. This feels like a chicken and egg issue.

https://help.adobe.com/en_US/framemaker/using/index.html#t=using-framemaker%2Fuser-guide%2FWS37D3BBAC-A1FA-4fe3-9217-84364402A9D9_ver12.0.html
On this page, Step 2? Why are we doing that? Isn't that already done?
Step 5 presents a dialog that says "myapplication" does not exist, but also to 
reset the application name or define a new one... Where how is that described?
Oh, I had a wild crazy idea, when setting the structured app, rather than 
picking one from the list, go black-hat rogue and randomly type something in. 
Who'd a thought? Oh, that doesn't work either.

What's next? Define this app in structapps.fm and just fill in the non-existant 
dtd file name and try again? Even doing that FM says my app does not exist. 
Seems I need a DTD to make an app, but I need an app to make a DTD.

Sorry I'm rambling now.

C2
Adobe 
FrameMaker
The complete Adobe FrameMaker (2020 release) Online User Guide (Online Help)
help.adobe.com

___

This message is from the Framers mailing list

Send messages to framers@lists.frameusers.com
Visit the list's homepage at  http://www.frameusers.com
Archives located at http://www.mail-archive.com/framers%40lists.frameusers.com/
Subscribe and unsubscribe at 
http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
Send administrative questions to listad...@frameusers.com