Skip to content

Commit 84c1e05

Browse files
nicowilliamsnicowilliams
committed
Add examples of using citations from the repo
1 parent 4877704 commit 84c1e05

File tree

6 files changed

+210
-182
lines changed

6 files changed

+210
-182
lines changed

Diff for: ‎test/test-i-d.html

+5-5
Large diffs are not rendered by default.

Diff for: ‎test/test-i-d.lyx

+57-27
Original file line numberDiff line numberDiff line change
@@ -686,6 +686,33 @@ item1 description of item 1
686686
item2 description of item 2
687687
\end_layout
688688

689+
\begin_layout Subsection
690+
Example References
691+
\end_layout
692+
693+
\begin_layout Standard
694+
Here's a reference to an Internet-Draft (by now published as an RFC):
695+
\begin_inset Flex EntityXRef
696+
status collapsed
697+
698+
\begin_layout Plain Layout
699+
I-D.ietf-oauth-v2
700+
\end_layout
701+
702+
\end_inset
703+
704+
.
705+
Note that we have a reference to RFC1113 that we're not referencing outside
706+
the references section (so there will be a warning about an unused reference
707+
when exporting to RFC); this reference is defined in XML embedded within
708+
an EmbeddedBibXML inset.
709+
\end_layout
710+
711+
\begin_layout Standard
712+
Note that the content in EntityXRef custom insets (used to refer to citations
713+
within the document) must be the anchors of those references.
714+
\end_layout
715+
689716
\begin_layout Subsection
690717
Conventions used in this document
691718
\end_layout
@@ -892,35 +919,38 @@ Normative References
892919
\end_layout
893920

894921
\begin_layout Standard
895-
\begin_inset Flex EmbeddedBibXML
896-
status open
922+
\begin_inset Flex BibXML
923+
status collapsed
897924

898925
\begin_layout Plain Layout
899-
<reference anchor='RFC2119'> <front> <title abbrev='RFC Key Words'>Key words
900-
for use in RFCs to Indicate Requirement Levels</title> <author initials='S.'
901-
surname='Bradner' fullname='Scott Bradner'> <organization>Harvard University</o
902-
rganization> <address> <postal> <street>1350 Mass.
903-
Ave.</street> <street>Cambridge</street> <street>MA 02138</street></postal>
904-
<phone>- +1 617 495 3864</phone> <email>[email protected]</email></address></autho
905-
r> <date year='1997' month='March' /> <area>General</area> <keyword>keyword</key
906-
word> <abstract> <t> In many standards track documents several words are
907-
used to signify the requirements in the specification.
908-
These words are often capitalized.
909-
This document defines these words as they should be interpreted in IETF
910-
documents.
911-
Authors who follow these guidelines should incorporate this phrase near
912-
the beginning of their document: <list> <t> The key words "MUST", "MUST
913-
NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED",
914-
"MAY", and "OPTIONAL" in this document are to be interpreted as described
915-
in RFC 2119.
916-
</t></list></t> <t> Note that the force of these words is modified by the
917-
requirement level of the document in which they are used.
918-
</t></abstract></front> <seriesInfo name='BCP' value='14' /> <seriesInfo
919-
name='RFC' value='2119' /> <format type='TXT' octets='4723' target='http://www.r
920-
fc-editor.org/rfc/rfc2119.txt' /> <format type='HTML' octets='17970' target='http:
921-
//xml.resource.org/public/rfc/html/rfc2119.html' /> <format type='XML' octets='5777
922-
' target='http://xml.resource.org/public/rfc/xml/rfc2119.xml' /> </reference>
923-
926+
\begin_inset CommandInset href
927+
LatexCommand href
928+
name "RFC2119"
929+
target "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml"
930+
931+
\end_inset
932+
933+
934+
\end_layout
935+
936+
\end_inset
937+
938+
939+
\end_layout
940+
941+
\begin_layout Standard
942+
\begin_inset Flex BibXML
943+
status collapsed
944+
945+
\begin_layout Plain Layout
946+
\begin_inset CommandInset href
947+
LatexCommand href
948+
name "I-D.ietf-oauth-v2"
949+
target "http://xml.resource.org/public/rfc/bibxml3/reference.I-D.ietf-oauth-v2.xml"
950+
951+
\end_inset
952+
953+
924954
\end_layout
925955

926956
\end_inset

Diff for: ‎test/test-i-d.txt

+39-39
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44
Network Working Group J. Doe
55
Internet-Draft Doe
66
Updates: RFC2119 (if approved) J. Sixpack
7-
Intended status: Informational January 4, 2013
8-
Expires: July 8, 2013
7+
Intended status: Informational July 11, 2013
8+
Expires: January 12, 2014
99

1010

1111
A Skeleton Internet-Draft Written in LyX
@@ -33,7 +33,7 @@ Status of this Memo
3333
time. It is inappropriate to use Internet-Drafts as reference
3434
material or to cite them other than as "work in progress."
3535

36-
This Internet-Draft will expire on July 8, 2013.
36+
This Internet-Draft will expire on January 12, 2014.
3737

3838
Copyright Notice
3939

@@ -52,15 +52,16 @@ Copyright Notice
5252

5353

5454

55-
Doe & Sixpack Expires July 8, 2013 [Page 1]
55+
Doe & Sixpack Expires January 12, 2014 [Page 1]
5656

57-
Internet-Draft Skeleton I-D January 2013
57+
Internet-Draft Skeleton I-D July 2013
5858

5959

6060
Table of Contents
6161

6262
1. Introduction . . . . . . . . . . . . . . . . . . . . . 3
63-
1.1. Conventions used in this document . . . . . . . . . . . 4
63+
1.1. Example References . . . . . . . . . . . . . . . . . . 4
64+
1.2. Conventions used in this document . . . . . . . . . . . 4
6465
2. Details . . . . . . . . . . . . . . . . . . . . . . . . 5
6566
2.1. A sub-section . . . . . . . . . . . . . . . . . . . . . 5
6667
2.1.1. A sub-sub-section . . . . . . . . . . . . . . . . . . . 5
@@ -107,10 +108,9 @@ Table of Contents
107108

108109

109110

110-
111-
Doe & Sixpack Expires July 8, 2013 [Page 2]
111+
Doe & Sixpack Expires January 12, 2014 [Page 2]
112112

113-
Internet-Draft Skeleton I-D January 2013
113+
Internet-Draft Skeleton I-D July 2013
114114

115115

116116
1. Introduction
@@ -164,32 +164,32 @@ Internet-Draft Skeleton I-D January 2013
164164

165165

166166

167-
Doe & Sixpack Expires July 8, 2013 [Page 3]
167+
Doe & Sixpack Expires January 12, 2014 [Page 3]
168168

169-
Internet-Draft Skeleton I-D January 2013
169+
Internet-Draft Skeleton I-D July 2013
170170

171171

172172
item1 description of item 1
173173

174174
item2 description of item 2
175175

176-
1.1. Conventions used in this document
177-
178-
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
179-
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
180-
document are to be interpreted as described in [RFC2119].
181-
182-
183-
184-
185-
186-
187-
188-
176+
1.1. Example References
189177

178+
Here's a reference to an Internet-Draft (by now published as an RFC):
179+
[I-D.ietf-oauth-v2]. Note that we have a reference to RFC1113 that
180+
we're not referencing outside the references section (so there will
181+
be a warning about an unused reference when exporting to RFC); this
182+
reference is defined in XML embedded within an EmbeddedBibXML inset.
190183

184+
Note that the content in EntityXRef custom insets (used to refer to
185+
citations within the document) must be the anchors of those
186+
references.
191187

188+
1.2. Conventions used in this document
192189

190+
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
191+
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
192+
document are to be interpreted as described in [RFC2119].
193193

194194

195195

@@ -220,9 +220,9 @@ Internet-Draft Skeleton I-D January 2013
220220

221221

222222

223-
Doe & Sixpack Expires July 8, 2013 [Page 4]
223+
Doe & Sixpack Expires January 12, 2014 [Page 4]
224224

225-
Internet-Draft Skeleton I-D January 2013
225+
Internet-Draft Skeleton I-D July 2013
226226

227227

228228
2. Details
@@ -276,16 +276,20 @@ Internet-Draft Skeleton I-D January 2013
276276

277277

278278

279-
Doe & Sixpack Expires July 8, 2013 [Page 5]
279+
Doe & Sixpack Expires January 12, 2014 [Page 5]
280280

281-
Internet-Draft Skeleton I-D January 2013
281+
Internet-Draft Skeleton I-D July 2013
282282

283283

284284
3. Normative References
285285

286286
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
287287
Requirement Levels", BCP 14, RFC 2119, March 1997.
288288

289+
[I-D.ietf-oauth-v2]
290+
Hardt, D., "The OAuth 2.0 Authorization Framework",
291+
draft-ietf-oauth-v2-31 (work in progress), August 2012.
292+
289293
[RFC1113] Linn, J., "Privacy enhancement for Internet electronic
290294
mail: Part I - message encipherment and authentication
291295
procedures", RFC 1113, August 1989.
@@ -328,13 +332,9 @@ Internet-Draft Skeleton I-D January 2013
328332

329333

330334

331-
332-
333-
334-
335-
Doe & Sixpack Expires July 8, 2013 [Page 6]
335+
Doe & Sixpack Expires January 12, 2014 [Page 6]
336336

337-
Internet-Draft Skeleton I-D January 2013
337+
Internet-Draft Skeleton I-D July 2013
338338

339339

340340
Appendix A. First Appendix
@@ -388,9 +388,9 @@ A.1. Sub-Appendix
388388

389389

390390

391-
Doe & Sixpack Expires July 8, 2013 [Page 7]
391+
Doe & Sixpack Expires January 12, 2014 [Page 7]
392392

393-
Internet-Draft Skeleton I-D January 2013
393+
Internet-Draft Skeleton I-D July 2013
394394

395395

396396
Appendix B. Last Appendix
@@ -444,9 +444,9 @@ Appendix B. Last Appendix
444444

445445

446446

447-
Doe & Sixpack Expires July 8, 2013 [Page 8]
447+
Doe & Sixpack Expires January 12, 2014 [Page 8]
448448

449-
Internet-Draft Skeleton I-D January 2013
449+
Internet-Draft Skeleton I-D July 2013
450450

451451

452452
Authors' Addresses
@@ -500,5 +500,5 @@ Authors' Addresses
500500

501501

502502

503-
Doe & Sixpack Expires July 8, 2013 [Page 9]
503+
Doe & Sixpack Expires January 12, 2014 [Page 9]
504504

Diff for: ‎test/test-i-d.unpg

+22-5
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44
Network Working Group J. Doe
55
Internet-Draft Doe
66
Updates: RFC2119 (if approved) J. Sixpack
7-
Intended status: Informational January 4, 2013
8-
Expires: July 8, 2013
7+
Intended status: Informational July 11, 2013
8+
Expires: January 12, 2014
99

1010

1111
A Skeleton Internet-Draft Written in LyX
@@ -33,7 +33,7 @@ Status of this Memo
3333
time. It is inappropriate to use Internet-Drafts as reference
3434
material or to cite them other than as "work in progress."
3535

36-
This Internet-Draft will expire on July 8, 2013.
36+
This Internet-Draft will expire on January 12, 2014.
3737

3838
Copyright Notice
3939

@@ -54,7 +54,8 @@ Copyright Notice
5454
Table of Contents
5555

5656
1. Introduction
57-
1.1. Conventions used in this document
57+
1.1. Example References
58+
1.2. Conventions used in this document
5859
2. Details
5960
2.1. A sub-section
6061
2.1.1. A sub-sub-section
@@ -114,7 +115,19 @@ Table of Contents
114115

115116
item2 description of item 2
116117

117-
1.1. Conventions used in this document
118+
1.1. Example References
119+
120+
Here's a reference to an Internet-Draft (by now published as an RFC):
121+
[I-D.ietf-oauth-v2]. Note that we have a reference to RFC1113 that
122+
we're not referencing outside the references section (so there will
123+
be a warning about an unused reference when exporting to RFC); this
124+
reference is defined in XML embedded within an EmbeddedBibXML inset.
125+
126+
Note that the content in EntityXRef custom insets (used to refer to
127+
citations within the document) must be the anchors of those
128+
references.
129+
130+
1.2. Conventions used in this document
118131

119132
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
120133
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
@@ -152,6 +165,10 @@ Table of Contents
152165
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
153166
Requirement Levels", BCP 14, RFC 2119, March 1997.
154167

168+
[I-D.ietf-oauth-v2]
169+
Hardt, D., "The OAuth 2.0 Authorization Framework",
170+
draft-ietf-oauth-v2-31 (work in progress), August 2012.
171+
155172
[RFC1113] Linn, J., "Privacy enhancement for Internet electronic
156173
mail: Part I - message encipherment and authentication
157174
procedures", RFC 1113, August 1989.

0 commit comments

Comments
 (0)