ARMY MIL-HDBK-2361 C-2012 ARMY DIGITAL PUBLICATIONS DEVELOPMENT IMPLEMENTATION GUIDE.pdf

1、NOT MEASUREMENTSENSITIVEMIL-HDBK-2361C15 January 2012SUPERSEDINGMIL-HDBK-2361B(AC)15 October 2004DEP AR TMENT OF DEFENSEHANDBOOKARM Y D IGIT AL P UBLICA TIONSDEVELOPMENT IMPLEMENT A TIO N G UIDEThis handbook is for guidance only . Do not cite this document as a requirement.AMSC N/A IPSCDISTRIBUTION

2、ST A TEMENT A . Appr oved for public r elease; distribution is unlimited.Provided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-MIL-HDBK-2361CFOREWORD1. This military handbook is approved for use by the Department of the Army and is available foruse by all

3、Departments and Agencies of the Department of Defense.2. This handbook provides guidance on the implementation of Standard Generalized MarkupLanguage (SGML) and Extensible Markup Language (XML) as it pertains to MILSTD2361,Department of Defense, Interface Standard, Army Digital Publications. This ha

4、ndbook is for guidanceonly . This handbook cannot be cited as a requirement. If it is, the contractor does not have to comply .3. This document supplements Army Departmental Manuals, Directives, and Military Standards, andprovides basic and fundamental information on Standard Generalized Markup Lang

5、uage (SGML) andExtensible Markup Language (XML) as it applies to MILSTD2361.4. The use of Courier font changes in this handbook represent SGML/XML document instancefragments. See the following example for the courier font.5. Address any beneficial comments (recommendations, additions, deletions) and

6、 any pertinent datawhich may be of use in improving this document should be addressed by letter to: Director , ArmyPublishing Directorate (APD), A TTN: AAHS-P AA-PS, 9351 Hall Road Building 1456, Fort Belvoir ,V A 22060-5447.Since contact information can change, you may want to verify the currency o

7、f thisaddress information using the ASSIST Online database at https:/assist.daps.dla.mil .iiProvided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-MIL-HDBK-2361CCONTENTSP ARAGRAPH P AGEV olume 1 GENERALPart I INTRODUCTION T O MIL-HDBK-23611 SCOPE . . . . .

8、. . . . . . . . . . . . . . . . . . . . . . 11.1 Scope . . . . . . . . . . . . . . . . . . . . . 11.2 Purpose . . . . . . . . . . . . . . . . . . . . . 11.3 Applicability . . . . . . . . . . . . . . . . . . . 11.4 Introduction . . . . . . . . . . . . . . . . . . . 11.5 Why SGML to XML . . . . . . .

9、. . . . . . . . . 12 APPLICABLE DOCUMENTS . . . . . . . . . . . . . . . . . . . . 22.1 General . . . . . . . . . . . . . . . . . . . . . 22.2 Government documents . . . . . . . . . . . . . . . . 22.2.1 Specifications, standards, and handbooks . . . . . . . . . . . 22.2.2 Other government documents a

10、nd publications . . . . . . . . . 22.3 Non-Government publications . . . . . . . . . . . . . . 32.3.1 Information documents for XML . . . . . . . . . . . . . 33 DEFINITIONS . . . . . . . . . . . . . . . . . . . . . . . . . 33.1 Acronyms . . . . . . . . . . . . . . . . . . . . 33.2 T erms . . . . . .

11、 . . . . . . . . . . . . . . . 64 LA YOUT , FORMA T , AND CONTENT . . . . . . . . . . . . . . . . . 1 14.1 Scope . . . . . . . . . . . . . . . . . . . . . 1 15 ACQUISITION OF ARMY PUBLICA TIONS INFORMA TION USING MIL-STD-2361 . . 1 15.1 Purpose . . . . . . . . . . . . . . . . . . . . . 1 15.2 Public

12、ations information process by domain . . . . . . . . . . 1 15.2.1 T echnical manual (TM) . . . . . . . . . . . . . . . . 1 15.2.2 T raining and doctrine . . . . . . . . . . . . . . . . . 1 15.2.3 Administrative . . . . . . . . . . . . . . . . . . . 1 15.2.4 Publications development requirements and

13、guidance . . . . . . . 125.3 MIL-STD-2361 acquisition, development and delivery process . . . . 125.3.1 Acquisition planning . . . . . . . . . . . . . . . . . 135.3.2 Contract/statement of work . . . . . . . . . . . . . . . 135.3.3 Data delivery . . . . . . . . . . . . . . . . . . . 146 SGML/XML REF

14、ERENCE MA TERIAL . . . . . . . . . . . . . . . . . 156.1 How to keep up with SGML/XML . . . . . . . . . . . . 156.2 SGML/XML users group . . . . . . . . . . . . . . . 156.3 International digital enterprise alliance (IDEAlliance) . . . . . . . . . . . 156.4 Books and magazines . . . . . . . . . . . .

15、 . . . . 156.5 Servers . . . . . . . . . . . . . . . . . . . . . 15Part II ARMY SGML/XML REGISTR Y AND LIBRAR Y (ASRL)7 ARMY SGML/XML REGISTR Y AND LIBRAR Y (ASRL) . . . . . . . . . . . 167.1 Introduction . . . . . . . . . . . . . . . . . . . 167.2 ASRL description . . . . . . . . . . . . . . . . .

16、. 167.2.1 ASRL capabilities . . . . . . . . . . . . . . . . . . 167.2.2 Standardization and reuse . . . . . . . . . . . . . . . 167.2.2.1 Direct reuse . . . . . . . . . . . . . . . . . . . 167.2.2.2 New SGML/XML object and construct development . . . . . . . 177.3 ASRL concept of operations . . . .

17、. . . . . . . . . . 177.3.1 Purpose of the ASRL . . . . . . . . . . . . . . . . 177.3.2 Background . . . . . . . . . . . . . . . . . . . . 177.3.3 ASRL or ganization . . . . . . . . . . . . . . . . . 177.3.4 ASRL services . . . . . . . . . . . . . . . . . . . 18iiiProvided by IHSNot for ResaleNo rep

18、roduction or networking permitted without license from IHS-,-,-MIL-HDBK-2361C7.3.5 ASRL assets . . . . . . . . . . . . . . . . . . . 187.3.6 Procedures for submitting existing SGML /XML objects and constructs . . 187.3.7 Procedures for submitting new SGML/XML object and constructrequirements . . . .

19、 . . . . . . . . . . . . . . . 197.4 ASRL operations . . . . . . . . . . . . . . . . . . 207.4.1 ASRL repository operations . . . . . . . . . . . . . . . 207.4.2 Assistance and problem reporting . . . . . . . . . . . . . 207.4.3 Access via the internet (WWW) . . . . . . . . . . . . . 207.5 Submittal

20、 package delivery . . . . . . . . . . . . . . . 227.5.1 Rationale for submission . . . . . . . . . . . . . . . . 227.5.1.1 New requirements . . . . . . . . . . . . . . . . . . 227.5.1.2 V ariant requirements . . . . . . . . . . . . . . . . . 237.5.2 DTD information . . . . . . . . . . . . . . . . .

21、. 237.5.3 DTD abstract . . . . . . . . . . . . . . . . . . . 247.5.3.1 Abstract Contents . . . . . . . . . . . . . . . . . . 247.5.3.2 Sample Abstract . . . . . . . . . . . . . . . . . . 257.5.4 Sample DTD . . . . . . . . . . . . . . . . . . . 257.5.5 Parse logs . . . . . . . . . . . . . . . . . . .

22、 . 257.5.6 Element/attribute list . . . . . . . . . . . . . . . . . 257.5.6.1 Element components . . . . . . . . . . . . . . . . . 257.5.6.2 Attribute components . . . . . . . . . . . . . . . . . 257.5.7 Stylesheet . . . . . . . . . . . . . . . . . . . . 267.5.8 Sample document instance . . . . . .

23、. . . . . . . . . 267.5.9 V ariant DTD filter . . . . . . . . . . . . . . . . . 26Part III INTRODUCTION T O XML8 INTRODUCTION T O XML . . . . . . . . . . . . . . . . . . . . . 278.1 Introduction . . . . . . . . . . . . . . . . . . . 278.1.1 XML experience . . . . . . . . . . . . . . . . . . 278.1.2

24、Four primary components . . . . . . . . . . . . . . . 278.2 What is XML . . . . . . . . . . . . . . . . . . . 278.2.1 XML requirements . . . . . . . . . . . . . . . . . 278.2.2 Why use XML . . . . . . . . . . . . . . . . . . 278.2.3 The digital publications development (DPD) program concept . . . .

25、. 278.2.4 XML reference . . . . . . . . . . . . . . . . . . 288.2.5 MILSTD2361 XML tags . . . . . . . . . . . . . . . 288.2.6 XML tutorial . . . . . . . . . . . . . . . . . . . 288.3 XML experience and expertise . . . . . . . . . . . . . . 288.3.1 T ypes of XML knowledge . . . . . . . . . . . . . .

26、. 288.3.1.1 Publications manager . . . . . . . . . . . . . . . . . 288.3.1.2 Publications author . . . . . . . . . . . . . . . . . 288.3.1.3 Publications editor . . . . . . . . . . . . . . . . . 288.3.1.4 Computer specialist . . . . . . . . . . . . . . . . . 288.4 XML overview . . . . . . . . . . .

27、. . . . . . . 288.4.1 XML is a markup language . . . . . . . . . . . . . . . 288.4.1.1 W ell-formed XML document . . . . . . . . . . . . . . 298.4.2 XML is not a processing language . . . . . . . . . . . . 298.4.3 Understanding XML as a text database . . . . . . . . . . . 298.5 XML composition . . .

28、 . . . . . . . . . . . . . . . 298.5.1 Document type definition (DTD) . . . . . . . . . . . . . 298.5.2 Document instances . . . . . . . . . . . . . . . . . 298.5.3 XML declaration . . . . . . . . . . . . . . . . . . 308.5.4 XML markup . . . . . . . . . . . . . . . . . . . 308.5.4.1 XML tags . . . .

29、 . . . . . . . . . . . . . . . . 308.5.4.2 Markup minimization . . . . . . . . . . . . . . . . . 308.5.4.3 Distinct categories . . . . . . . . . . . . . . . . . . 318.5.4.4 Attributes 1 . . . . . . . . . . . . . . . . . . . . 31ivProvided by IHSNot for ResaleNo reproduction or networking permitted w

30、ithout license from IHS-,-,-MIL-HDBK-2361C8.5.4.4.1 Y es-no . . . . . . . . . . . . . . . . . . . . . 318.5.4.4.2 V alue list . . . . . . . . . . . . . . . . . . . . 328.5.4.4.3 Name token (NMT OKEN) . . . . . . . . . . . . . . . 328.5.4.4.4 Name token list (NMT OKENS) . . . . . . . . . . . . . 328.

31、5.4.4.5 Unique identifier (ID) . . . . . . . . . . . . . . . . 328.5.4.4.6 Identifier reference (IDREF) . . . . . . . . . . . . . . . 328.5.4.4.7 Identifier reference list (IDREFS) . . . . . . . . . . . . . 328.5.4.4.8 Entity name (ENTITY) . . . . . . . . . . . . . . . . 328.5.4.4.9 Entity name list

32、 (ENTITIES) . . . . . . . . . . . . . . 328.5.4.4.10 Character data (CDA T A) . . . . . . . . . . . . . . . . 338.5.4.5 Entities . . . . . . . . . . . . . . . . . . . . . 338.5.4.6 V alidation of XML markup . . . . . . . . . . . . . . . 338.5.4.7 Stylesheets . . . . . . . . . . . . . . . . . . . . 3

33、48.5.4.7.1 Generated text . . . . . . . . . . . . . . . . . . . 348.5.4.7.1.1 Generating text with elements . . . . . . . . . . . . . . 348.5.4.7.1.2 Generating text with attributes . . . . . . . . . . . . . . 348.5.4.8 Extensible stylesheet language for formatting objects (XSL-FO) . . . . 348.5.4.9

34、 Formatting output specification instance (FOSI) . . . . . . . . . 349 XML TUT ORIAL . . . . . . . . . . . . . . . . . . . . . . . . 359.1 Scope . . . . . . . . . . . . . . . . . . . . . 359.2 Applicable documents . . . . . . . . . . . . . . . . 359.3 Document type definition (DTD) . . . . . . . . .

35、 . . . . 359.3.1 Document elements . . . . . . . . . . . . . . . . . 359.3.2 Parsable character data #PCDA T A . . . . . . . . . . . . . 359.3.3 Sequence and occurrence indicators . . . . . . . . . . . . 359.3.3.1 Sequence indicators . . . . . . . . . . . . . . . . . 359.3.3.2 Occurrence indicators

36、. . . . . . . . . . . . . . . . . 359.3.3.3 Content model element sub-groups . . . . . . . . . . . . . 359.3.4 Attribute declaration . . . . . . . . . . . . . . . . . 369.3.4.1 Attribute value types and reserved XML names . . . . . . . . . 369.3.4.2 Keyword attribute defaults . . . . . . . . . . . .

37、 . . . 369.3.5 Entities . . . . . . . . . . . . . . . . . . . . . 379.3.5.1 Parameter entity . . . . . . . . . . . . . . . . . . 379.3.5.1.1 Replacement text entities . . . . . . . . . . . . . . . . 379.3.5.1.2 Nested entities . . . . . . . . . . . . . . . . . . . 379.3.5.1.3 External files . . . .

38、. . . . . . . . . . . . . . . 379.3.5.2 General entity . . . . . . . . . . . . . . . . . . . 389.3.5.2.1 Replacement text entities . . . . . . . . . . . . . . . . 389.3.5.2.2 Nested entities . . . . . . . . . . . . . . . . . . . 389.3.5.3 Graphic entities . . . . . . . . . . . . . . . . . . 389.3.5.

39、3.1 Graphic notation identifier . . . . . . . . . . . . . . . 389.3.5.3.2 SYSTEM vs. PUBLIC identifier . . . . . . . . . . . . . 399.3.5.3.3 Graphic entity key names . . . . . . . . . . . . . . . 399.3.5.3.4 Exchanging graphic files . . . . . . . . . . . . . . . . 399.3.5.4 Unicode character set . .

40、 . . . . . . . . . . . . . . . 399.3.5.4.1 Unicode two-byte value . . . . . . . . . . . . . . . . 399.3.5.4.2 UTF-8 . . . . . . . . . . . . . . . . . . . . . 399.3.5.5 ISO character entities . . . . . . . . . . . . . . . . . 399.3.5.5.1 Non-keyboard characters . . . . . . . . . . . . . . . . 399.3.5

41、.5.2 MIL-HDBK-2361 DTDs ISO character sets . . . . . . . . . . 4010 INTRODUCTION T O MIL-STD-2361 XML MARKUP . . . . . . . . . . . . 4010.1 Scope . . . . . . . . . . . . . . . . . . . . . 4010.2 Introduction to MIL-STD-2361 XML markup . . . . . . . . . 4010.2.1 T ypes of tags in MIL-STD-2361 . . . .

42、 . . . . . . . . . 4010.2.1.1 Applying content tags . . . . . . . . . . . . . . . . 4010.2.1.2 T agging legacy data . . . . . . . . . . . . . . . . . 40vProvided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-MIL-HDBK-2361C10.2.1.3 Applying structural tags .

43、 . . . . . . . . . . . . . . . 4210.2.1.3.1 T itles . . . . . . . . . . . . . . . . . . . . . 4210.2.1.3.2 Paragraphs . . . . . . . . . . . . . . . . . 4210.2.1.3.3 Procedures . . . . . . . . . . . . . . . . . . . . 4210.2.1.3.4 Determination of procedure, task, or work package designation . . . . 4

44、210.2.1.3.5 Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4310.2.1.3.6 Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4310.2.1.3.6.1 Random lists . . . . . . . . . . . . . . . . . . . 4410.2.1.3.6.2 Sequential lists . . . . . . . . . . . . . . . . . .

45、 4410.2.1.3.6.3 Definition lists . . . . . . . . . . . . . . . . . . . 4410.2.1.3.6.4 Numbered lists . . . . . . . . . . . . . . . . . . 4410.2.1.4 T ables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4410.2.1.4.1 CALS tables . . . . . . . . . . . . . . . . . . . 4410.2.1.4.2 Figu

46、res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4510.2.1.4.3 Graphics . . . . . . . . . . . . . . . . . . . . 4510.2.1.4.4 Alphabetic index . . . . . . . . . . . . . . . 4510.2.1.4.5 W arnings, cautions, and notes . . . . . . . . . . . . . . 4610.2.1.4.6 Assigning attribute value

47、s . . . . . . . . . . . . . . . 471 1 STYLESHEET/FOSI APPLICA TION AS A STYLE GUIDE . . . . . . . . . . . 481 1.1 Scope . . . . . . . . . . . . . . . . . . . . . 481 1.2 Using stylesheets or formatting output specification instances (FOSIs) . . 481 1.2.1 Style . . . . . . . . . . . . . . . . . . . .

48、 . 481 1.2.2 The output specification (OS) . . . . . . . . . . . . . . 481 1.3 FOSIs in the ASRL . . . . . . . . . . . . . . . . . 481 1.4 Using a FOSI . . . . . . . . . . . . . . . . . . . 491 1.5 Stylesheets . . . . . . . . . . . . . . . . . . . . 491 1.5.1 XPath (XP A TH) . . . . . . . . . . . .

49、. . . . . . 491 1.5.2 Extensible stylesheet language (XSL) . . . . . . . . . . . . 491 1.5.3 Extensible stylesheet language transformations (XSL T) . . . . . . . 491 1.5.4 Extensible stylesheet language for formatting objects (XSL-FO) . . . . 50V olume 2 ADMINISTRA TIVE PUBLICA TIONSPart I OVER VIEW , GUIDANCE AND WORKFLOW12 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 5112.1 Overview . . . . . . . . . . . . . .