Electronic Component Manufacturer Datasheet Library (ECMdata)
From: http://www.marshall.com/ecmdata/ecmdata.dtd
Date: 1999-01-13
DTD Version:  November 19, 1998

-------------------------------------------------------------------------

<!--
*******************************************************************************
* Electronic Component Manufacturer Datasheet Library (ECMdata)
*
* ecmdata.dtd: A DTD for exposing datasheet libraries on websites for the 
*              automation of indexing and linking datasheets to part numbers
*	       or series.
*
* November 19, 1998 by Andy Brown, Marshall Industries, abrown@marshall.com
*
* NOTE : A working group is now forming to help bring this proposal to full
* 	 workability and acceptance. All are encouraged to join the effort 
* 	 and will not be charged to do so. Please contact Andy Brown at 
*  	 Marshall Industries for details.
*******************************************************************************
//-->


<!ELEMENT ecmdata (company)>
	<!ATTLIST ecmdata	
		type			(library|
			 	 	 notification) "library"
		publish_date		CDATA 	#REQUIRED>

<!-- 
	ecmdata is the parent or root item and contains a company
	ecmdata attributes consist of :
	
	    - type: type of ecmdata document. Could be a library that is 
	            stored on the vendor's server, or a notification that
	            is "pushed" out to subscribers notifying them about 
	            the update.
	    - publish_date : The day that this ecmdata.xml document was
	    	    updated in mm-dd-yyyy format.
//-->


<!ELEMENT company (contacts,library)>
	<!ATTLIST company
		company_name		CDATA	#REQUIRED
		website			CDATA	#REQUIRED
		document_root_url	CDATA	#REQUIRED>

<!-- 
     company attributes consist of :

          - company_name: REQUIRED
          - website: 	REQUIRED address for the company's main website 
          	      	Ex: "www.company.com"
          - document_root_url: 	REQUIRED root url for the datasheets. 
          		This may reroute to an FTP based url...
          		Ex: ftp://ftp.company.com/datasheets
          		Ex: http://www.company.com/pdf

     company elements contain :
     
          contacts: 	contacts collection
          datasheets: 	datasheets collection
//-->


		
<!ELEMENT contacts (contact+)>

<!-- The contacts collection for company -->


<!ELEMENT contact EMPTY>
	<!ATTLIST contact
		contact_name	CDATA	#IMPLIED	
		email		CDATA	#REQUIRED	
		phone		CDATA	#IMPLIED>
		
<!--
	contact attributes :
		- contact_name:	OPTIONAL name of the contact
		- email:	REQUIRED email address. uses would include
				troubleshooting and updating
		- phone:	OPTIONAL phone number
//-->		


<!ELEMENT library (datasheet)+>
<!-- A library holds the collection of one or more datasheets -->

<!ELEMENT datasheet (parts_association+, parts_description?)>
	<!ATTLIST datasheet
     		type 		(primary|
     				 appnotes|
     				 selector) 	"primary"
     		status		(new|
     				 obsolete|
     				 active) 	"active"
     		title 		CDATA 	#REQUIRED
     		rev 		CDATA 	#IMPLIED
     		publish_date	CDATA	#IMPLIED 
     		url		CDATA 	#REQUIRED
     		size_kb		CDATA	#IMPLIED>
     		
<!-- 
	Attributes of a datasheet:
     	
          - type: 	Enumerated type of datasheet. Currently there are three
          			choices: 

          			"primary": the primary source of information,
          				   including parametric data. This is
          				   the DEFAULT.

          			"appnotes":special application notes for the
          				   particular series or device

          			"selector_guide": a quick summary sheet of 
          				parametric difference between devices
          				in the same series.                				    				
          - status:	Enumerated status of the datasheet :
          			"new": 	This has just been introduced and is the
          				first time within the ecmdata listing.
          				There may be some way to mark active 
          				after the first listing in the tools.
          			"obsolete": This datasheet document is obsolete.
          			"active" : the datasheet is currently active.
          - title: 	REQUIRED official title of the datasheet
          - rev: 	OPTIONAL datasheet revision
          - date: 	OPTIONAL datasheet publish date (mm-dd-yy OR mm-yy)
          - url: 	REQUIRED logical url or location of the datasheet. 
                         If http://www.company.com/ or ftp://ftp.company.com 
                         is omitted, the datasheet-location can be appended 
                         to the root-url to fully resolve the location.
          - size_kb: 	OPTIONAL datasheet size in kilobytes.
                         
	Datasheets can contain:                 
    
          parts_association:  REQUIRED one or more part number identifiers to
          		     associate or link the datasheet to a particular 
          		     part number or series. The identifier may be full
          		     part numbers, a series name, or identifiers 
          		     including wildcards to associate a set of part
          		     numbers.
     
          parts_description: OPTIONAL free-form paragraph describing the series
          		     or parts outlined in the document.
                         
//-->


     
<!ELEMENT parts_association (#PCDATA)>
	<!ATTLIST parts_association
		type	(part_number|
			 series|
			 wildcard) "wildcard">
			 
<!-- 
	parts_association is free-form text 
	parts_association attributes are :
	    - type: 	enumerated - This attribute tells the processing agent 
				which type of association to use:
				     "part_number" - part identifier is a full 
				     		part number
				     "series" - the official series name to 
				     		associate this document to.
				     "wildcard" - used in the automatic matching 
				     		of existing part number tables.
				     	        May use * for many characters
				     	        or ? for a single character.
//-->

<!ELEMENT parts_description (#PCDATA)>
<!-- parts descriptions are free-form text paragraphs describing the parts -->

<!-- END OF DTD -->