]> git.lyx.org Git - lyx.git/blob - lib/examples/PDF-comment.lyx
Update docs
[lyx.git] / lib / examples / PDF-comment.lyx
1 #LyX 2.2 created this file. For more info see http://www.lyx.org/
2 \lyxformat 504
3 \begin_document
4 \begin_header
5 \save_transient_properties true
6 \origin /systemlyxdir/examples/
7 \textclass scrartcl
8 \begin_preamble
9 % to be able to use all color settings of pdfcomment
10 \usepackage[svgnames,rgb]{xcolor}
11
12 % if pdflatex is used
13 \usepackage{ifpdf}
14 \ifpdf
15
16 % set fonts for nicer pdf view
17 \IfFileExists{lmodern.sty}
18  {\usepackage{lmodern}}{}
19
20 \fi % end if pdflatex is used
21 \end_preamble
22 \options BCOR8mm,pagesize
23 \use_default_options false
24 \begin_modules
25 pdfcomment
26 \end_modules
27 \maintain_unincluded_children false
28 \language english
29 \language_package default
30 \inputencoding auto
31 \fontencoding global
32 \font_roman "default" "default"
33 \font_sans "default" "default"
34 \font_typewriter "default" "default"
35 \font_math "auto" "auto"
36 \font_default_family default
37 \use_non_tex_fonts false
38 \font_sc false
39 \font_osf false
40 \font_sf_scale 100 100
41 \font_tt_scale 100 100
42 \graphics default
43 \default_output_format pdf2
44 \output_sync 0
45 \bibtex_command bibtex
46 \index_command default
47 \paperfontsize 12
48 \spacing single
49 \use_hyperref true
50 \pdf_title "Description of the module PDF Comments"
51 \pdf_author "Uwe Stöhr"
52 \pdf_subject "PDF comments"
53 \pdf_keywords "LyX, PDF comments, pdfcomment"
54 \pdf_bookmarks true
55 \pdf_bookmarksnumbered true
56 \pdf_bookmarksopen true
57 \pdf_bookmarksopenlevel 2
58 \pdf_breaklinks false
59 \pdf_pdfborder false
60 \pdf_colorlinks true
61 \pdf_backref false
62 \pdf_pdfusetitle false
63 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
64 \papersize a4paper
65 \use_geometry false
66 \use_package amsmath 1
67 \use_package amssymb 1
68 \use_package cancel 0
69 \use_package esint 1
70 \use_package mathdots 1
71 \use_package mathtools 1
72 \use_package mhchem 1
73 \use_package stackrel 0
74 \use_package stmaryrd 0
75 \use_package undertilde 0
76 \cite_engine basic
77 \cite_engine_type default
78 \biblio_style plain
79 \use_bibtopic false
80 \use_indices false
81 \paperorientation portrait
82 \suppress_date true
83 \justification true
84 \use_refstyle 0
85 \notefontcolor #0000ff
86 \index Index
87 \shortcut idx
88 \color #008000
89 \end_index
90 \secnumdepth 3
91 \tocdepth 2
92 \paragraph_separation skip
93 \defskip medskip
94 \quotes_language english
95 \papercolumns 1
96 \papersides 1
97 \paperpagestyle default
98 \tracking_changes false
99 \output_changes false
100 \html_math_output 0
101 \html_css_as_file 0
102 \html_be_strict false
103 \end_header
104
105 \begin_body
106
107 \begin_layout Standard
108 \begin_inset Flex PDF-Comment-Setup
109 status open
110
111 \begin_layout Plain Layout
112 color=yellow
113 \end_layout
114
115 \end_inset
116
117
118 \begin_inset Note Note
119 status collapsed
120
121 \begin_layout Plain Layout
122 This sets yellow as default color for new PDF comments, see sec.
123 \begin_inset space ~
124 \end_inset
125
126
127 \begin_inset CommandInset ref
128 LatexCommand ref
129 reference "subsec:PDF-Comment-setup"
130
131 \end_inset
132
133  for the description.
134 \end_layout
135
136 \end_inset
137
138
139 \end_layout
140
141 \begin_layout Title
142 Description of the module PDF Comments
143 \end_layout
144
145 \begin_layout Author
146 Uwe Stöhr
147 \end_layout
148
149 \begin_layout Standard
150 The \SpecialChar LaTeX
151  package 
152 \series bold
153 pdfcomment
154 \series default
155  provides full access for PDF comments.
156  You can add normal comments as well as margin comments, underlining etc..
157  You can also define a special layout for a comment which you can use several
158  times in the document.
159  This document is only a excerpt of the documentation of 
160 \series bold
161 pdfcomment
162 \series default
163 ; see its documentation for all information:
164 \begin_inset Newline newline
165 \end_inset
166
167
168 \begin_inset Flex URL
169 status open
170
171 \begin_layout Plain Layout
172
173 http://mirrors.ctan.org/macros/latex/contrib/pdfcomment/doc/pdfcomment.pdf
174 \end_layout
175
176 \end_inset
177
178
179 \end_layout
180
181 \begin_layout Section
182 The different comment types
183 \end_layout
184
185 \begin_layout Standard
186 The different comment types are inserted using the menu 
187 \family sans
188 Insert\SpecialChar menuseparator
189 Custom
190 \begin_inset space ~
191 \end_inset
192
193 Insets
194 \family default
195 .
196  You can select one of the following:
197 \end_layout
198
199 \begin_layout Subsection
200 PDF-Annotation
201 \end_layout
202
203 \begin_layout Standard
204 This is the standard PDF comment.
205  Here is an example: 
206 \begin_inset Flex PDF-Annotation
207 status open
208
209 \begin_layout Plain Layout
210 This is a simple PDF-Annotation.
211 \end_layout
212
213 \end_inset
214
215
216 \end_layout
217
218 \begin_layout Standard
219 Like for all PDF comment types you can add a lot of things to the option
220  of the inset.
221  To insert the options inset, set the cursor into the comment inset and
222  use the menu 
223 \family sans
224 Insert\SpecialChar menuseparator
225 PDF Comment Options
226 \family default
227 .
228 \end_layout
229
230 \begin_layout Standard
231 \begin_inset Note Greyedout
232 status open
233
234 \begin_layout Plain Layout
235
236 \series bold
237 Note:
238 \series default
239  All braces and brackets in comment options must be inserted as \SpecialChar TeX
240  code!
241 \end_layout
242
243 \end_inset
244
245
246 \begin_inset Newline newline
247 \end_inset
248
249
250 \end_layout
251
252 \begin_layout Standard
253 Here is an example PDF-Annotation where the author is set to 
254 \begin_inset Quotes eld
255 \end_inset
256
257 Daisy Duck
258 \begin_inset Quotes erd
259 \end_inset
260
261
262 \begin_inset Flex PDF-Annotation
263 status open
264
265 \begin_layout Plain Layout
266 \begin_inset Argument 1
267 status collapsed
268
269 \begin_layout Plain Layout
270 author=
271 \begin_inset ERT
272 status collapsed
273
274 \begin_layout Plain Layout
275
276 {
277 \end_layout
278
279 \end_inset
280
281 Daisy Duck
282 \begin_inset ERT
283 status collapsed
284
285 \begin_layout Plain Layout
286
287 }
288 \end_layout
289
290 \end_inset
291
292 ,color=
293 \begin_inset ERT
294 status collapsed
295
296 \begin_layout Plain Layout
297
298 {
299 \end_layout
300
301 \end_inset
302
303 0.234 0.867 0.211
304 \begin_inset ERT
305 status collapsed
306
307 \begin_layout Plain Layout
308
309 }
310 \end_layout
311
312 \end_inset
313
314 ,voffset=8pt,opacity=0.5
315 \end_layout
316
317 \end_inset
318
319 This is an annotation with a complex option.
320 \end_layout
321
322 \end_inset
323
324
325 \end_layout
326
327 \begin_layout Standard
328 To avoid to write the same options like the author again and again, you
329  can define a so-called 
330 \begin_inset Quotes eld
331 \end_inset
332
333 avatar
334 \begin_inset Quotes erd
335 \end_inset
336
337  for every person and/or comment layout.
338  See 
339 \begin_inset CommandInset ref
340 LatexCommand ref
341 reference "sec:Avatars"
342
343 \end_inset
344
345  for further information.
346 \end_layout
347
348 \begin_layout Standard
349 For a full list of possible options, please look at the 
350 \series bold
351 pdfcomment
352 \series default
353  documentation.
354 \end_layout
355
356 \begin_layout Subsection
357 PDF-Circle
358 \end_layout
359
360 \begin_layout Standard
361 This will typeset a comment in form of a circle or ellipse.
362  Here is an example without any options: 
363 \begin_inset Flex PDF-Circle
364 status open
365
366 \begin_layout Plain Layout
367 a simple circle comment
368 \end_layout
369
370 \end_inset
371
372
373 \end_layout
374
375 \begin_layout Standard
376 At the right side you see a large, elliptical comment as example of a PDF-Circle
377  with options.
378  
379 \begin_inset Flex PDF-Circle
380 status open
381
382 \begin_layout Plain Layout
383 \begin_inset Argument 1
384 status collapsed
385
386 \begin_layout Plain Layout
387 id=1,color=blue,height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=8cm,opacity=1.0,just
388 ification=right,icolor=
389 \begin_inset ERT
390 status collapsed
391
392 \begin_layout Plain Layout
393
394 {
395 \end_layout
396
397 \end_inset
398
399 yellow
400 \begin_inset ERT
401 status collapsed
402
403 \begin_layout Plain Layout
404
405 }
406 \end_layout
407
408 \end_inset
409
410 ,linewidth=12pt,borderstyle=dashed,dashstyle=
411 \begin_inset ERT
412 status collapsed
413
414 \begin_layout Plain Layout
415
416 {
417 \end_layout
418
419 \end_inset
420
421 10 5
422 \begin_inset ERT
423 status collapsed
424
425 \begin_layout Plain Layout
426
427 }
428 \end_layout
429
430 \end_inset
431
432
433 \end_layout
434
435 \end_inset
436
437 a circle comment in form of a large ellipse
438 \end_layout
439
440 \end_inset
441
442
443 \begin_inset Newline newline
444 \end_inset
445
446
447 \begin_inset Newline newline
448 \end_inset
449
450
451 \begin_inset Newline newline
452 \end_inset
453
454
455 \end_layout
456
457 \begin_layout Subsection
458 PDF-Freetext
459 \end_layout
460
461 \begin_layout Standard
462 This will typeset a comment in form of a freely positioned box.
463  By using the option 
464 \series bold
465 type=callout
466 \series default
467  the box will have an additional so called callout line, to bind the box
468  to a certain element of the page.
469  With the option 
470 \series bold
471 type=typewriter
472 \series default
473  you can write a comment everywhere on the page with a virtual ’typewriter’.
474  These PDF-Freetext annotations do have no frame and a transparent background
475  for ’overwriting’ arbitrary parts of the page.
476  Here is an example in form of a yellow rectangle:
477 \begin_inset Flex PDF-Freetext
478 status open
479
480 \begin_layout Plain Layout
481 \begin_inset Argument 1
482 status collapsed
483
484 \begin_layout Plain Layout
485 height=3cm,type=freetext,subject={freetext},width=4.5cm,voffset=-3.2cm,hoffset=-3.2
486 cm,opacity=0.9,justification=right
487 \end_layout
488
489 \end_inset
490
491 This is also a comment, but it is a PDF-Freetext annotation.
492 \end_layout
493
494 \end_inset
495
496
497 \begin_inset Newline newline
498 \end_inset
499
500
501 \begin_inset Newline newline
502 \end_inset
503
504
505 \begin_inset Newline newline
506 \end_inset
507
508
509 \begin_inset Newline newline
510 \end_inset
511
512
513 \end_layout
514
515 \begin_layout Subsection
516 PDF-Line
517 \end_layout
518
519 \begin_layout Standard
520 This will typeset a comment in form of a line, polyline or polygon.
521  Here is an example without any options: 
522 \begin_inset Flex PDF-Line
523 status open
524
525 \begin_layout Plain Layout
526 a simple PDF-Line comment
527 \end_layout
528
529 \end_inset
530
531
532 \begin_inset Newline newline
533 \end_inset
534
535
536 \end_layout
537
538 \begin_layout Standard
539 As you can see a PDF-Line comment without options is useless.
540 \end_layout
541
542 \begin_layout Standard
543 The green arrow at the left side of this page is an example for a PDF-Line
544  comment with options.
545  
546 \begin_inset Flex PDF-Line
547 status open
548
549 \begin_layout Plain Layout
550 \begin_inset Argument 1
551 status collapsed
552
553 \begin_layout Plain Layout
554 type=line,opacity=1,line=
555 \begin_inset ERT
556 status collapsed
557
558 \begin_layout Plain Layout
559
560 {
561 \end_layout
562
563 \end_inset
564
565 50 480 50 180
566 \begin_inset ERT
567 status collapsed
568
569 \begin_layout Plain Layout
570
571 }
572 \end_layout
573
574 \end_inset
575
576 ,color=green,icolor=blue,caption=top,linebegin=
577 \begin_inset ERT
578 status collapsed
579
580 \begin_layout Plain Layout
581
582 {
583 \end_layout
584
585 \end_inset
586
587 /ROpenArrow
588 \begin_inset ERT
589 status collapsed
590
591 \begin_layout Plain Layout
592
593 }
594 \end_layout
595
596 \end_inset
597
598 ,lineend=
599 \begin_inset ERT
600 status collapsed
601
602 \begin_layout Plain Layout
603
604 {
605 \end_layout
606
607 \end_inset
608
609 /OpenArrow
610 \begin_inset ERT
611 status collapsed
612
613 \begin_layout Plain Layout
614
615 }
616 \end_layout
617
618 \end_inset
619
620 ,linewidth=2bp,captionhoffset=-5pt,captionvoffset=15pt
621 \end_layout
622
623 \end_inset
624
625 a PDF-Line comment with options
626 \end_layout
627
628 \end_inset
629
630
631 \end_layout
632
633 \begin_layout Subsection
634 PDF-Margin
635 \end_layout
636
637 \begin_layout Standard
638 This will typeset an annotation into the margin.
639  Right besides this text is an example without options: 
640 \begin_inset Flex PDF-Margin
641 status open
642
643 \begin_layout Plain Layout
644 a simple PDF-Margin comment
645 \end_layout
646
647 \end_inset
648
649
650 \end_layout
651
652 \begin_layout Standard
653 The red margin note is an example for a PDF-Margin with options.
654  
655 \begin_inset Flex PDF-Margin
656 status open
657
658 \begin_layout Plain Layout
659 \begin_inset Argument 1
660 status collapsed
661
662 \begin_layout Plain Layout
663 icon=Note,color=red,open=true,hspace=100pt
664 \end_layout
665
666 \end_inset
667
668 a PDF-Margin comment with options
669 \end_layout
670
671 \end_inset
672
673
674 \end_layout
675
676 \begin_layout Subsection
677 PDF-Markup
678 \end_layout
679
680 \begin_layout Standard
681 This will typeset so called PDF text markup annotations over some text or
682  math.
683  Here is a markup without options: 
684 \begin_inset Flex PDF-Markup
685 status open
686
687 \begin_layout Plain Layout
688 simple PDF-Markup
689 \end_layout
690
691 \end_inset
692
693
694 \end_layout
695
696 \begin_layout Standard
697 Possible types for the option 
698 \series bold
699 markup
700 \series default
701  are:
702 \end_layout
703
704 \begin_layout Description
705 Highlight The markup text will be highlighted: 
706 \begin_inset Flex PDF-Markup
707 status open
708
709 \begin_layout Plain Layout
710 \begin_inset Argument 1
711 status open
712
713 \begin_layout Plain Layout
714 \begin_inset Note Note
715 status open
716
717 \begin_layout Plain Layout
718 id=1,
719 \end_layout
720
721 \end_inset
722
723 markup=Highlight
724 \end_layout
725
726 \end_inset
727
728 Highlight PDF-Markup
729 \begin_inset Argument post:1
730 status open
731
732 \begin_layout Plain Layout
733 a comment
734 \end_layout
735
736 \end_inset
737
738
739 \end_layout
740
741 \end_inset
742
743
744 \begin_inset Note Note
745 status collapsed
746
747 \begin_layout Plain Layout
748 see the next section for the description of the option 
749 \series bold
750 id=1
751 \end_layout
752
753 \end_inset
754
755
756 \end_layout
757
758 \begin_layout Description
759 Underline The markup text will be underlined: 
760 \begin_inset Flex PDF-Markup
761 status open
762
763 \begin_layout Plain Layout
764 \begin_inset Argument 1
765 status open
766
767 \begin_layout Plain Layout
768 markup=Underline
769 \end_layout
770
771 \end_inset
772
773 Underlining PDF-Markup
774 \end_layout
775
776 \end_inset
777
778
779 \end_layout
780
781 \begin_layout Description
782 Squiggly The markup text will be underlined with a wave: 
783 \begin_inset Flex PDF-Markup
784 status open
785
786 \begin_layout Plain Layout
787 \begin_inset Argument 1
788 status open
789
790 \begin_layout Plain Layout
791 markup=Squiggly
792 \end_layout
793
794 \end_inset
795
796 Underwave PDF-Markup
797 \end_layout
798
799 \end_inset
800
801
802 \end_layout
803
804 \begin_layout Description
805 StrikeOut The markup text will be struck-out: 
806 \begin_inset Flex PDF-Markup
807 status open
808
809 \begin_layout Plain Layout
810 \begin_inset Argument 1
811 status open
812
813 \begin_layout Plain Layout
814 markup=StrikeOut
815 \end_layout
816
817 \end_inset
818
819 Striked-out PDF-Markup
820 \end_layout
821
822 \end_inset
823
824
825 \end_layout
826
827 \begin_layout Description
828 mathpopup Formula parts will be highlighted.
829
830 \series bold
831  
832 \series default
833
834 \begin_inset Note Greyedout
835 status open
836
837 \begin_layout Plain Layout
838
839 \series bold
840 Note:
841 \series default
842  The PDF-Markup inset cannot be used for this option!
843 \end_layout
844
845 \end_inset
846
847  Instead the command 
848 \series bold
849
850 \backslash
851 pdfmarkupcomment
852 \series default
853  woll be used in a formula with this scheme:
854 \begin_inset Newline newline
855 \end_inset
856
857 Command:
858 \begin_inset Newline newline
859 \end_inset
860
861
862 \series bold
863
864 \backslash
865 pdfmarkupcomment[style=mathpopup]
866 \backslash
867 {formula part}
868 \begin_inset Formula $\to$
869 \end_inset
870
871
872 \backslash
873 {
874 \backslash
875 text
876 \begin_inset space \textvisiblespace{}
877 \end_inset
878
879
880 \begin_inset Newline newline
881 \end_inset
882
883 optional comment}
884 \begin_inset Newline newline
885 \end_inset
886
887
888 \series default
889 Result:
890 \end_layout
891
892 \begin_layout Standard
893 \begin_inset Formula 
894 \[
895 \pdfmarkupcomment[style=mathpopup]{\sum_{i=1}^{n}i=\frac{1}{2}n\cdot(n+1)}{\text{little Gauss}}
896 \]
897
898 \end_inset
899
900
901 \end_layout
902
903 \begin_layout Standard
904 The text for the comment is inserted with the inset option 
905 \family sans
906 Comment
907 \family default
908 .
909 \end_layout
910
911 \begin_layout Standard
912 PDF-Markup has some limitations:
913 \end_layout
914
915 \begin_layout Itemize
916 the markup text must not be longer than one paragraph
917 \end_layout
918
919 \begin_layout Itemize
920 the markup annotation must not be longer than one page, otherwise the recognitio
921 n of the page break will fail
922 \end_layout
923
924 \begin_layout Itemize
925 when using Xe\SpecialChar TeX
926  you have to assure that the page dimensions are internally
927  output, e.
928 \begin_inset space \thinspace{}
929 \end_inset
930
931 g.
932 \begin_inset space \space{}
933 \end_inset
934
935 with the document class option 
936 \series bold
937 pagesize
938 \series default
939  for the KOMA-Script classes, or the option 
940 \series bold
941 pagesize
942 \series default
943  for the \SpecialChar LaTeX
944 -package 
945 \series bold
946 typearea
947 \series default
948 .
949 \end_layout
950
951 \begin_layout Subsection
952 PDF-Reply
953 \end_layout
954
955 \begin_layout Standard
956 \begin_inset Note Greyedout
957 status open
958
959 \begin_layout Plain Layout
960
961 \series bold
962 Attention:
963 \series default
964  Due to technical limitations PDF-Reply only works when using pdflatex.
965  On some \SpecialChar LaTeX
966  installations it won't even work in general.
967 \end_layout
968
969 \end_inset
970
971
972 \end_layout
973
974 \begin_layout Standard
975 With a PDF-Reply you can compose replies to PDF comments.
976  The option 
977 \series bold
978 replyto
979 \series default
980  provides a clear reference to the comment the reply refers to.
981 \end_layout
982
983 \begin_layout Standard
984 As example see the reply to the Highlight PDF-Markup from the previous section.
985  
986 \begin_inset Note Note
987 status open
988
989 \begin_layout Plain Layout
990 \begin_inset Flex PDF-Reply
991 status open
992
993 \begin_layout Plain Layout
994 \begin_inset Argument 1
995 status open
996
997 \begin_layout Plain Layout
998 id=2,replyto=1,date=D:20101211161247+01'00'
999 \end_layout
1000
1001 \end_inset
1002
1003 This is a reply.
1004 \end_layout
1005
1006 \end_inset
1007
1008
1009 \end_layout
1010
1011 \end_inset
1012
1013  It appears in that PDF-Markup comment.
1014  To be able to reference the PDF-Markup the option 
1015 \series bold
1016 id=1
1017 \series default
1018  was added to its options.
1019  The PDF-Reply got the option 
1020 \series bold
1021 replyto=1
1022 \series default
1023 .
1024 \end_layout
1025
1026 \begin_layout Standard
1027 You can also reply to replies by adding an 
1028 \series bold
1029 id
1030 \series default
1031  option to the reply that should be replied to.
1032  As example see the reply to the reply to the PDF-Markup.
1033  
1034 \begin_inset Note Note
1035 status open
1036
1037 \begin_layout Plain Layout
1038 \begin_inset Flex PDF-Reply
1039 status open
1040
1041 \begin_layout Plain Layout
1042 \begin_inset Argument 1
1043 status open
1044
1045 \begin_layout Plain Layout
1046 replyto=2,date=D:20101212095321+01'00'
1047 \end_layout
1048
1049 \end_inset
1050
1051 Of course, you can reply to a reply.
1052 \end_layout
1053
1054 \end_inset
1055
1056
1057 \end_layout
1058
1059 \end_inset
1060
1061
1062 \end_layout
1063
1064 \begin_layout Standard
1065 PDF-Reply has limitations:
1066 \end_layout
1067
1068 \begin_layout Itemize
1069 It can not support page breaks.
1070 \end_layout
1071
1072 \begin_layout Itemize
1073 The replies will only appear in the PDF annotations on the second page.
1074  (Replies to comments without page break work smoothly.)
1075 \end_layout
1076
1077 \begin_layout Subsection
1078 PDF-Sideline
1079 \end_layout
1080
1081 \begin_layout Standard
1082 This will typeset a comment in form of identical markers on every side of
1083  the page.
1084  The yellow arrows besides this text are an example of a PDF-Sideline without
1085  any options: 
1086 \begin_inset Flex PDF-Sideline
1087 status open
1088
1089 \begin_layout Plain Layout
1090 a simple PDF-Sideline
1091 \end_layout
1092
1093 \end_inset
1094
1095
1096 \end_layout
1097
1098 \begin_layout Standard
1099 As you can see a PDF-Sideline comment without options is quite useless.
1100  PDF-Sideline is useful if you want to highlight complete parts of a page.
1101  The inset options define the layout of the marker while the normal content
1102  of the inset is the text surrounded by the markers.
1103  The content of the inset option 
1104 \family sans
1105 Comment
1106 \family default
1107  will be printed along both markers.
1108  Here is an example:
1109 \end_layout
1110
1111 \begin_layout Standard
1112 \begin_inset Flex PDF-Sideline
1113 status open
1114
1115 \begin_layout Plain Layout
1116 \begin_inset Argument 1
1117 status collapsed
1118
1119 \begin_layout Plain Layout
1120 opacity=0.33,color=magenta,icolor=cyan,caption=inline,linebegin=
1121 \begin_inset ERT
1122 status collapsed
1123
1124 \begin_layout Plain Layout
1125
1126 {
1127 \end_layout
1128
1129 \end_inset
1130
1131 /Butt
1132 \begin_inset ERT
1133 status collapsed
1134
1135 \begin_layout Plain Layout
1136
1137 }
1138 \end_layout
1139
1140 \end_inset
1141
1142 ,lineend=
1143 \begin_inset ERT
1144 status collapsed
1145
1146 \begin_layout Plain Layout
1147
1148 {
1149 \end_layout
1150
1151 \end_inset
1152
1153 /Square
1154 \begin_inset ERT
1155 status collapsed
1156
1157 \begin_layout Plain Layout
1158
1159 }
1160 \end_layout
1161
1162 \end_inset
1163
1164 ,linewidth=3bp,linesep=0.7cm
1165 \end_layout
1166
1167 \end_inset
1168
1169 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1170  eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1171  voluptua.
1172  At vero eos et accusam et justo duo dolores et ea rebum.
1173  Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1174  sit amet.
1175  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1176  eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1177  voluptua.
1178 \end_layout
1179
1180 \begin_layout Plain Layout
1181 At vero eos et accusam et justo duo dolores et ea rebum.
1182  Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1183  sit amet.
1184  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1185  eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1186  voluptua.
1187  At vero eos et accusam et justo duo dolores et ea rebum.
1188  Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1189  sit amet.
1190 \begin_inset Argument 2
1191 status open
1192
1193 \begin_layout Plain Layout
1194 Comment text
1195 \end_layout
1196
1197 \end_inset
1198
1199
1200 \end_layout
1201
1202 \end_inset
1203
1204
1205 \end_layout
1206
1207 \begin_layout Standard
1208 PDF-Sideline has some limitations:
1209 \end_layout
1210
1211 \begin_layout Itemize
1212 the comment should not be longer than one page, otherwise the recognition
1213  of the page could fail
1214 \end_layout
1215
1216 \begin_layout Itemize
1217 when using Xe\SpecialChar TeX
1218  you have to assure that the page dimensions are internally
1219  output, e.
1220 \begin_inset space \thinspace{}
1221 \end_inset
1222
1223 g.
1224 \begin_inset space \space{}
1225 \end_inset
1226
1227 with the document class option 
1228 \series bold
1229 pagesize
1230 \series default
1231  for the KOMA-Script classes, or the option 
1232 \series bold
1233 pagesize
1234 \series default
1235  for the \SpecialChar LaTeX
1236 -package 
1237 \series bold
1238 typearea
1239 \series default
1240 .
1241 \end_layout
1242
1243 \begin_layout Subsection
1244 PDF-Square
1245 \end_layout
1246
1247 \begin_layout Standard
1248 This will typeset a rectangular box.
1249  Here is an example without any options: 
1250 \begin_inset Flex PDF-Square
1251 status open
1252
1253 \begin_layout Plain Layout
1254 a simple PDF-Square comment
1255 \end_layout
1256
1257 \end_inset
1258
1259
1260 \end_layout
1261
1262 \begin_layout Standard
1263 Below this text you see a rectangle comment with a curvy outline as example
1264  of a PDF-Square with options.
1265 \end_layout
1266
1267 \begin_layout Standard
1268 \begin_inset Flex PDF-Square
1269 status open
1270
1271 \begin_layout Plain Layout
1272 \begin_inset Argument 1
1273 status collapsed
1274
1275 \begin_layout Plain Layout
1276 height=2cm,width=4.8cm,voffset=-2cm,hoffset=1cm,opacity=1.0,justification=right,ic
1277 olor=CornflowerBlue,bse=cloudy,bsei=2.5,linewidth=8pt
1278 \end_layout
1279
1280 \end_inset
1281
1282 A fancy PDF-Square comment
1283 \end_layout
1284
1285 \end_inset
1286
1287
1288 \begin_inset Newline newline
1289 \end_inset
1290
1291
1292 \begin_inset Newline newline
1293 \end_inset
1294
1295
1296 \begin_inset Newline newline
1297 \end_inset
1298
1299
1300 \begin_inset Newline newline
1301 \end_inset
1302
1303
1304 \end_layout
1305
1306 \begin_layout Subsection
1307 PDF-Tooltip
1308 \end_layout
1309
1310 \begin_layout Standard
1311 With this you can annotate any object with a tooltip.
1312 \begin_inset Foot
1313 status open
1314
1315 \begin_layout Plain Layout
1316 All objects that can be set into a \SpecialChar TeX
1317 -box to measure its size.
1318 \end_layout
1319
1320 \end_inset
1321
1322
1323 \end_layout
1324
1325 \begin_layout Standard
1326 The PDF-Tooltip inset has a mandatory argument for the tooltip.
1327  The object that should be annotated is set into the PDF-Tooltip inset,
1328  the tooltip is written into the mandatory argument.
1329  Here is as example of a word with a tooltip: 
1330 \begin_inset Flex PDF-Tooltip
1331 status open
1332
1333 \begin_layout Plain Layout
1334 \begin_inset Argument post:1
1335 status open
1336
1337 \begin_layout Plain Layout
1338 This is a tooltip!
1339 \end_layout
1340
1341 \end_inset
1342
1343
1344 \color red
1345 word
1346 \end_layout
1347
1348 \end_inset
1349
1350
1351 \end_layout
1352
1353 \begin_layout Standard
1354 Since a tooltip can be used for almost any object, one can also use it for
1355  chemical notations in math: 
1356 \begin_inset Flex PDF-Tooltip
1357 status open
1358
1359 \begin_layout Plain Layout
1360 \begin_inset Argument post:1
1361 status open
1362
1363 \begin_layout Plain Layout
1364 Sulfuric acid
1365 \end_layout
1366
1367 \end_inset
1368
1369
1370 \begin_inset Formula $\ce{H2SO4}$
1371 \end_inset
1372
1373
1374 \end_layout
1375
1376 \end_inset
1377
1378
1379 \end_layout
1380
1381 \begin_layout Standard
1382 The PDF-Tooltip inset has also an option that is used to correct the size
1383  of the tooltip for math (if necessary) or to disable an annotation.
1384  Here is an example with a mathstyle option:
1385 \end_layout
1386
1387 \begin_layout Standard
1388 \begin_inset Flex PDF-Tooltip
1389 status open
1390
1391 \begin_layout Plain Layout
1392 \begin_inset Argument 1
1393 status open
1394
1395 \begin_layout Plain Layout
1396 mathstyle=
1397 \begin_inset ERT
1398 status collapsed
1399
1400 \begin_layout Plain Layout
1401
1402
1403 \backslash
1404 displaystyle
1405 \end_layout
1406
1407 \end_inset
1408
1409  
1410 \end_layout
1411
1412 \end_inset
1413
1414
1415 \begin_inset Argument post:1
1416 status open
1417
1418 \begin_layout Plain Layout
1419 little Gauß
1420 \end_layout
1421
1422 \end_inset
1423
1424
1425 \begin_inset Formula $\sum_{i=1}^{n}i=\frac{1}{2}n\cdot(n+1)$
1426 \end_inset
1427
1428
1429 \end_layout
1430
1431 \end_inset
1432
1433  
1434 \end_layout
1435
1436 \begin_layout Section
1437 Comment definitions
1438 \end_layout
1439
1440 \begin_layout Standard
1441 The package 
1442 \series bold
1443 pdfcomment
1444 \series default
1445  provides the following environments to define or change PDF comments:
1446 \end_layout
1447
1448 \begin_layout Subsection
1449 PDF-Comment setup
1450 \begin_inset CommandInset label
1451 LatexCommand label
1452 name "subsec:PDF-Comment-setup"
1453
1454 \end_inset
1455
1456
1457 \end_layout
1458
1459 \begin_layout Standard
1460 With this custom inset you can reset the global (document-wide) options
1461  at any time.
1462  For example the default color for new PDF comments is blue.
1463  To get Adobe Reader's yellow colored notes for all comments in your document,
1464  add the PDF comment setup inset to the beginning of your document and insert
1465  there the option 
1466 \series bold
1467 color=yellow
1468 \series default
1469 .
1470  This was also done in this document.
1471 \end_layout
1472
1473 \begin_layout Standard
1474 By using its optional option 
1475 \series bold
1476 local
1477 \series default
1478  you can keep the reset local within a group enclosed by \SpecialChar TeX
1479 -braces.
1480  For example you want to reset the color only for two consecutive comments,
1481  then enclose the PDF comment setup inset and the two comment insets in
1482  \SpecialChar TeX
1483 -braces.
1484  Here is an example:
1485 \end_layout
1486
1487 \begin_layout Standard
1488 \begin_inset ERT
1489 status collapsed
1490
1491 \begin_layout Plain Layout
1492
1493 {
1494 \end_layout
1495
1496 \end_inset
1497
1498
1499 \begin_inset Flex PDF-Comment-Setup
1500 status open
1501
1502 \begin_layout Plain Layout
1503 \begin_inset Argument 1
1504 status open
1505
1506 \begin_layout Plain Layout
1507 local
1508 \end_layout
1509
1510 \end_inset
1511
1512 color=Orange
1513 \end_layout
1514
1515 \end_inset
1516
1517
1518 \begin_inset Flex PDF-Markup
1519 status collapsed
1520
1521 \begin_layout Plain Layout
1522 PDF-Markup in orange
1523 \end_layout
1524
1525 \end_inset
1526
1527
1528 \begin_inset space ~
1529 \end_inset
1530
1531
1532 \begin_inset space ~
1533 \end_inset
1534
1535
1536 \begin_inset space ~
1537 \end_inset
1538
1539
1540 \begin_inset Flex PDF-Annotation
1541 status collapsed
1542
1543 \begin_layout Plain Layout
1544 PDF-Annotation in orange
1545 \end_layout
1546
1547 \end_inset
1548
1549
1550 \begin_inset ERT
1551 status collapsed
1552
1553 \begin_layout Plain Layout
1554
1555 }
1556 \end_layout
1557
1558 \end_inset
1559
1560
1561 \begin_inset Flex PDF-Margin
1562 status collapsed
1563
1564 \begin_layout Plain Layout
1565 default PDF-Margin comment
1566 \end_layout
1567
1568 \end_inset
1569
1570
1571 \end_layout
1572
1573 \begin_layout Subsection
1574 PDF Comment style
1575 \end_layout
1576
1577 \begin_layout Standard
1578 This environment allows you to define a style for a PDF comment that can
1579  be used by several comments.
1580  Assuming you write a Math tutorial and want to add popup explanations in
1581  the PDF for several expressions, then insert a PDF Comment style environment
1582  before your first formula.
1583  Name it for example 
1584 \series bold
1585 MathPopup
1586 \series default
1587 , set the color to white with 
1588 \series bold
1589 color=white
1590 \series default
1591  and highlight the whole formula with 
1592 \series bold
1593 markup=Highlight
1594 \series default
1595 .
1596 \end_layout
1597
1598 \begin_layout Define PDF-Comment Style
1599 \begin_inset Argument 1
1600 status open
1601
1602 \begin_layout Plain Layout
1603 MathPopup
1604 \end_layout
1605
1606 \end_inset
1607
1608 color=white,markup=Highlight
1609 \end_layout
1610
1611 \begin_layout Standard
1612 In the comments use the option 
1613 \series bold
1614 style=MathPopup
1615 \series default
1616  to use your style.
1617  Here is an example:
1618 \end_layout
1619
1620 \begin_layout Standard
1621 \begin_inset Flex PDF-Markup
1622 status open
1623
1624 \begin_layout Plain Layout
1625 \begin_inset Argument 1
1626 status open
1627
1628 \begin_layout Plain Layout
1629
1630 \family roman
1631 \series medium
1632 \shape up
1633 \size normal
1634 \emph off
1635 \bar no
1636 \strikeout off
1637 \uuline off
1638 \uwave off
1639 \noun off
1640 \color none
1641 style=
1642 \family default
1643 \series default
1644 \shape default
1645 \size default
1646 \emph default
1647 \bar default
1648 \strikeout default
1649 \uuline default
1650 \uwave default
1651 \noun default
1652 \color inherit
1653 MathPopup
1654 \end_layout
1655
1656 \end_inset
1657
1658
1659 \begin_inset Formula $P(E)$
1660 \end_inset
1661
1662
1663 \begin_inset Argument post:1
1664 status open
1665
1666 \begin_layout Plain Layout
1667
1668 \family roman
1669 \series medium
1670 \shape up
1671 \size normal
1672 \emph off
1673 \bar no
1674 \strikeout off
1675 \uuline off
1676 \uwave off
1677 \noun off
1678 \color none
1679 Probability of event E
1680 \end_layout
1681
1682 \end_inset
1683
1684
1685 \end_layout
1686
1687 \end_inset
1688
1689
1690 \end_layout
1691
1692 \begin_layout Subsection
1693 \begin_inset CommandInset label
1694 LatexCommand label
1695 name "sec:Avatars"
1696
1697 \end_inset
1698
1699 Avatars
1700 \end_layout
1701
1702 \begin_layout Standard
1703 If you are for example reviewing a document, you need to add your name to
1704  every of your comments.
1705  In case you use a special layout of your annotations, you would have to
1706  do a lot of copy-paste work.
1707  But this can be avoided if you define for every comment author a special
1708  avatar.
1709 \end_layout
1710
1711 \begin_layout Standard
1712 Assuming your name is 
1713 \begin_inset Quotes eld
1714 \end_inset
1715
1716 Oleg Testman
1717 \begin_inset Quotes erd
1718 \end_inset
1719
1720  you can define an avatar for your name using the environment 
1721 \family sans
1722 Define
1723 \begin_inset space ~
1724 \end_inset
1725
1726 Avatar
1727 \family default
1728 .
1729  Its mandatory option is the name.
1730  In your case, name it 
1731 \series bold
1732 Oleg
1733 \series default
1734 .
1735  Add behind the name of the avatar your name as author by writing 
1736 \series bold
1737 author={Oleg Testman}
1738 \series default
1739 .
1740 \begin_inset Newline newline
1741 \end_inset
1742
1743 You might use a special icon to see at the first look which comments were
1744  made by you.
1745  You therefore add behind the author-statement, separated by a comma, 
1746 \begin_inset Quotes eld
1747 \end_inset
1748
1749
1750 \series bold
1751 icon=Check
1752 \series default
1753
1754 \begin_inset Quotes erd
1755 \end_inset
1756
1757  to get a checkmark.
1758 \begin_inset Foot
1759 status open
1760
1761 \begin_layout Plain Layout
1762 For all possible icons, see the 
1763 \series bold
1764 pdfcomment
1765 \series default
1766  manual.
1767 \end_layout
1768
1769 \end_inset
1770
1771  the checkmark should have a green color so that you add 
1772 \series bold
1773 color=lime
1774 \series default
1775  to the avatar definition.
1776  Your whole definition reads now
1777 \begin_inset Newline newline
1778 \end_inset
1779
1780
1781 \series bold
1782 author={Oleg Testman},icon=Check,color=lime
1783 \end_layout
1784
1785 \begin_layout Define Avatar
1786 \begin_inset Argument 1
1787 status open
1788
1789 \begin_layout Plain Layout
1790 Oleg
1791 \end_layout
1792
1793 \end_inset
1794
1795 author={Oleg Testman},icon=Check,color=lime
1796 \end_layout
1797
1798 \begin_layout Standard
1799 To use now your avatar for PDF comments you have two choices:
1800 \end_layout
1801
1802 \begin_layout Enumerate
1803 You set up that all PDF comments in the document use your avatar.
1804  This is done by inserting the custom inset 
1805 \family sans
1806 PDF
1807 \begin_inset space ~
1808 \end_inset
1809
1810 Comment-Setup
1811 \family default
1812  before the first PDF comment in your document.
1813  Insert to this inset 
1814 \series bold
1815 avatar=Oleg
1816 \series default
1817 .
1818 \end_layout
1819
1820 \begin_layout Enumerate
1821 You add 
1822 \series bold
1823 avatar=Oleg
1824 \series default
1825  to the options of a particular PDF comment.
1826  The avatar will then only be used for this comment.
1827 \end_layout
1828
1829 \begin_layout Standard
1830 Here is an example for the 
1831 \family sans
1832 PDF
1833 \begin_inset space ~
1834 \end_inset
1835
1836 Comment-Setup
1837 \family default
1838  method:
1839 \begin_inset Flex PDF-Comment-Setup
1840 status open
1841
1842 \begin_layout Plain Layout
1843 avatar=Oleg
1844 \end_layout
1845
1846 \end_inset
1847
1848
1849 \begin_inset Flex PDF-Annotation
1850 status open
1851
1852 \begin_layout Plain Layout
1853 Oleg said: Wow, that's nice!
1854 \end_layout
1855
1856 \end_inset
1857
1858
1859 \begin_inset Newline newline
1860 \end_inset
1861
1862 and here is another comment:
1863 \begin_inset Flex PDF-Annotation
1864 status open
1865
1866 \begin_layout Plain Layout
1867 Oleg also said: I hate to repeat myself.
1868 \end_layout
1869
1870 \end_inset
1871
1872
1873 \end_layout
1874
1875 \begin_layout Define Avatar
1876 \begin_inset Argument 1
1877 status open
1878
1879 \begin_layout Plain Layout
1880 Dolittle
1881 \end_layout
1882
1883 \end_inset
1884
1885 color=NavyBlue,opacity=0.5,open=false,icon=Circle,author={Dr.
1886  Dolittle}
1887 \end_layout
1888
1889 \begin_layout Standard
1890 Here is an example where another avatar 
1891 \begin_inset Quotes eld
1892 \end_inset
1893
1894 Dolittle
1895 \begin_inset Quotes erd
1896 \end_inset
1897
1898  is only used for this comment:
1899 \begin_inset Flex PDF-Margin
1900 status open
1901
1902 \begin_layout Plain Layout
1903 \begin_inset Argument 1
1904 status open
1905
1906 \begin_layout Plain Layout
1907 avatar=Dolittle
1908 \end_layout
1909
1910 \end_inset
1911
1912 I am Dr.
1913  Dolittle! Respect my authority!
1914 \end_layout
1915
1916 \end_inset
1917
1918
1919 \end_layout
1920
1921 \begin_layout Section
1922 List of PDF comments
1923 \end_layout
1924
1925 \begin_layout Standard
1926 You can insert a list with all PDF comments using the environment 
1927 \family sans
1928 List of PDF comments
1929 \family default
1930 .
1931  By specifying options for it you can determine what parts of the comments
1932  should appear in the list.
1933  Here is the list for this document where only the comments of a defined
1934  author are printed:
1935 \end_layout
1936
1937 \begin_layout List of PDF Comments
1938 \begin_inset Argument 1
1939 status open
1940
1941 \begin_layout Plain Layout
1942 liststyle=
1943 \begin_inset ERT
1944 status collapsed
1945
1946 \begin_layout Plain Layout
1947
1948 {
1949 \end_layout
1950
1951 \end_inset
1952
1953 AuthorComment
1954 \begin_inset ERT
1955 status collapsed
1956
1957 \begin_layout Plain Layout
1958
1959 }
1960 \end_layout
1961
1962 \end_inset
1963
1964 , heading =
1965 \begin_inset ERT
1966 status collapsed
1967
1968 \begin_layout Plain Layout
1969
1970 {
1971 \end_layout
1972
1973 \end_inset
1974
1975 List of PDF comments
1976 \begin_inset ERT
1977 status collapsed
1978
1979 \begin_layout Plain Layout
1980
1981 }
1982 \end_layout
1983
1984 \end_inset
1985
1986
1987 \end_layout
1988
1989 \end_inset
1990
1991
1992 \end_layout
1993
1994 \begin_layout Standard
1995 You can also define your own style using the environment
1996 \begin_inset Newline newline
1997 \end_inset
1998
1999
2000 \family sans
2001 Define
2002 \begin_inset space ~
2003 \end_inset
2004
2005 PDF
2006 \begin_inset space ~
2007 \end_inset
2008
2009 Comment
2010 \begin_inset space ~
2011 \end_inset
2012
2013 List
2014 \begin_inset space ~
2015 \end_inset
2016
2017 Style
2018 \begin_inset Newline newline
2019 \end_inset
2020
2021
2022 \family default
2023 if you know enough about the tricky \SpecialChar LaTeX
2024  internals.
2025  With the environment
2026 \begin_inset Newline newline
2027 \end_inset
2028
2029
2030 \family sans
2031 Set
2032 \begin_inset space ~
2033 \end_inset
2034
2035 PDF
2036 \begin_inset space ~
2037 \end_inset
2038
2039 Comment
2040 \begin_inset space ~
2041 \end_inset
2042
2043 List
2044 \begin_inset space ~
2045 \end_inset
2046
2047 Style
2048 \begin_inset Newline newline
2049 \end_inset
2050
2051
2052 \family default
2053 you can set a list style.
2054 \end_layout
2055
2056 \begin_layout Define PDF-Comment List Style
2057 \begin_inset Argument 1
2058 status open
2059
2060 \begin_layout Plain Layout
2061 MyStyle
2062 \end_layout
2063
2064 \end_inset
2065
2066
2067 \backslash
2068 makeatletter
2069 \backslash
2070 pc@lopt@author
2071 \backslash
2072  - 
2073 \backslash
2074 pc@lopt@subject
2075 \backslash
2076  (
2077 \backslash
2078 pc@lopt@deadline)
2079 \backslash
2080 makeatother
2081 \end_layout
2082
2083 \begin_layout Set PDF-Comment List Style
2084 AuthorCommentDeadline
2085 \end_layout
2086
2087 \begin_layout Standard
2088 \begin_inset Note Greyedout
2089 status open
2090
2091 \begin_layout Plain Layout
2092
2093 \series bold
2094 Note:
2095 \series default
2096  Only one list of comments can be printed in the PDF.
2097 \end_layout
2098
2099 \end_inset
2100
2101
2102 \end_layout
2103
2104 \begin_layout Section
2105 General Hints
2106 \end_layout
2107
2108 \begin_layout Itemize
2109 To be able to use all kinds of colors and color definitions you must load
2110  the \SpecialChar LaTeX
2111  package 
2112 \series bold
2113 xcolor
2114 \series default
2115  in the document preamble this way:
2116 \begin_inset Newline newline
2117 \end_inset
2118
2119
2120 \series bold
2121
2122 \backslash
2123 usepackage[svgnames,rgb]{xcolor}
2124 \end_layout
2125
2126 \begin_layout Itemize
2127 If you have two consecutive PDF
2128 \begin_inset space ~
2129 \end_inset
2130
2131 comment insets, the will appear in the PDF one over each other:
2132 \begin_inset Flex PDF-Comment-Setup
2133 status open
2134
2135 \begin_layout Plain Layout
2136 avatar=Oleg
2137 \end_layout
2138
2139 \end_inset
2140
2141
2142 \begin_inset Flex PDF-Annotation
2143 status open
2144
2145 \begin_layout Plain Layout
2146 Oleg said: Wow, that's nice!
2147 \end_layout
2148
2149 \end_inset
2150
2151
2152 \begin_inset Flex PDF-Annotation
2153 status open
2154
2155 \begin_layout Plain Layout
2156 Oleg also said: I hate to repeat myself.
2157 \end_layout
2158
2159 \end_inset
2160
2161
2162 \begin_inset Newline newline
2163 \end_inset
2164
2165 To avoid that separate them with whitespace like protected space:
2166 \begin_inset Flex PDF-Annotation
2167 status open
2168
2169 \begin_layout Plain Layout
2170 Oleg said: Wow, that's nice!
2171 \end_layout
2172
2173 \end_inset
2174
2175
2176 \begin_inset space ~
2177 \end_inset
2178
2179
2180 \begin_inset space ~
2181 \end_inset
2182
2183
2184 \begin_inset space ~
2185 \end_inset
2186
2187
2188 \begin_inset space ~
2189 \end_inset
2190
2191
2192 \begin_inset space ~
2193 \end_inset
2194
2195
2196 \begin_inset space ~
2197 \end_inset
2198
2199
2200 \begin_inset space ~
2201 \end_inset
2202
2203
2204 \begin_inset Flex PDF-Annotation
2205 status open
2206
2207 \begin_layout Plain Layout
2208 Oleg also said: I hate to repeat myself.
2209 \end_layout
2210
2211 \end_inset
2212
2213
2214 \end_layout
2215
2216 \begin_layout Itemize
2217 You cannot use non-Latin characters in your comment or in the author name.
2218  The reason is that PDFs use a special character encoding that is not compatible
2219  with \SpecialChar LaTeX
2220 .
2221 \end_layout
2222
2223 \end_body
2224 \end_document