نام (NAME)

synctex — پرونده کمکی فناوری همگام‌سازی تک (Synchronize TeXnology)

توضیحات (DESCRIPTION)

پرونده‌های کمکی فناوری همگام‌سازی تک (Synchronize TeXnology help files) (synctexs) پرونده‌های متنی هستند که به همگام‌سازی ورودی/خروجی در طول آماده‌سازی سند با سامانه حروف‌چینی TeX کمک می‌کنند.

مفاهیم پایه (BASICS)

ساختار این پرونده نباید عمومی تلقی شود، به این معنا که هیچ‌کس نباید نیازی به تجزیه محتویات آن داشته باشد، مگر ابزار خط فرمان synctex و کتابخانه synctex_parser که هر دو به صورت عمومی در دسترس هستند. مگر در مواردی که کاملاً اجتناب‌ناپذیر باشد، دسترسی به محتویات پرونده synctex تنها باید از طریق درخواست‌ها به ابزار خط فرمان synctex انجام گیرد.

ساختار (STRUCTURE)

ساختار عناصر یک پرونده synctex فهرستی از رکوردهای خط متنی به شرح زیر است. علامت‌های ‘*’, ‘+’, و ‘?’ معانی متداول خود در EBNF را دارند: ‘*’ به معنای صفر یا بیشتر، ‘+’ به معنای یک یا بیشتر، و ‘?’ به معنای صفر یا یک (یعنی اختیاری) است.

• <SyncTeX> ::= (کل محتوا در ۴ بخش)
  • <دیباچه (Preamble)>
  • <محتوا (Content)>
  • <مؤخره (Postamble)>
  • <پی‌نوشت (Post Scriptum)>

هر بخش با نخستین وقوع یک خط بخش‌بندی آغاز می‌شود و با بخش بعدی، در صورت وجود، به پایان می‌رسد. در تعاریف زیر، شرایط پایان بخش ذکر نشده است.

دیباچه (The preamble)

• <Preamble> ::=
  • "SyncTeX Version:" <Version Number> <EOL>
  • <Input Line>*
  • "Magnification:" <TeX magnification> <EOL>
  • "Unit:" <unit in scaled point> <EOL>
  • "X Offset:" <horizontal offset in scaled point> <EOL>
  • "Y Offset:" <vertical offset in scaled point> <EOL>
• <Input Line> ::= "Input:" <tag> ":" <File Name> <EOL>

محتوا (The content)

• <Content> ::=
  • <byte offset record>
  • "Content:" <EOL>
  • (<Form(k)>|<Input Line>)*
  • <sheet(1)>
  • (<Form(k)>|<Input Line>)*
  • <sheet(2)>
  • (<Form(k)>|<Input Line>)*
  • ...
  • <sheet(N)>
  • (<Form(k)>|<Input Line>)*
• <byte offset record> ::= "!" <byte offset> <end of record>

• <sheet(n)> ::=
  • <byte offset record>
  • "{" <the integer n> <end of record>
  • <vbox section>|<hbox section>
  • <byte offset record>
  • "}" <the integer n> <end of record>
• <Form> ::=
  • <byte offset record>
  • "<" <form tag> <end of record>
  • <vbox section>|<hbox section>
  • <byte offset record>
  • ">" <end of record>
• <form tag> ::= <integer>

فرم‌ها در pdfTeX در دسترس هستند. تمام اعداد اعدادی صحیح هستند که با نمایش ده‌دهی در محلی‌سازی "C" کدگذاری شده‌اند. عبارت <box content> آنچه را که درون یک جعبه است توصیف می‌کند. این جعبه یا یک جعبه عمودی (vbox) یا افقی (hbox) است، همراه با رکوردهایی مرتبط با گره‌های glue، kern یا ریاضی.

• <box content> ::=
  • <vbox section>|<hbox section>
  • |<void vbox record>|<void hbox record>
  • |<current record>|<glue record>|<kern record>
  • |<math record>|<form ref record>|<Form>
• <vbox section> ::=
  • "[" <link> ":" <point> ":" <size> <end of record>
  • <box content>*
  • "]" <end of record>
• <hbox section> ::=
  • ( <link> ":" <point> ":" <size> <end of record>
  • <box content>*
  • ")" <end of record>

جعبه‌های خالی (Void boxes):

• <void vbox record> ::= "v" <link> ":" <point> ":" <size> <end of record>
• <void hbox record> ::= "h" <link> ":" <point> ":" <size> <end of record>
• <link> ::= <tag> "," <line>( "," <column>)?
• <point> ::= <full point>|<compressed point>
• <full point> ::= <integer> "," <integer>
• <compressed point> ::= <integer> ",="
• <line> ::= <integer>
• <column> ::= <integer>
• <size> ::= <Width> "," <Height> "," <Depth>
• <Width> ::= <integer>
• <Height> ::= <integer>
• <Depth> ::= <integer>

رکوردهای بعدی رکوردهای تک‌خطی پایه‌ای هستند.

• <current record> ::= "x" <link> ":" <point> <end of record>
• <kern record> ::= "k" <link> ":" <point> ":" <Width> <end of record>
• <glue record> ::= "g" <link> ":" <point> <end of record>
• <math record> ::= "$" <link> ":" <point> <end of record>
• <form ref record> ::= "f" <form tag> ":" <point> <end of record>

مؤخره (The postamble)

مؤخره پرونده را می‌بندد. اگر مؤخره‌ای وجود نداشته باشد، به این معنی است که فرآیند حروف‌چینی به درستی پایان نیافته است.

• <Postamble>::=
  • <byte offset record>
  • "Count:" <Number of records> <EOL>

پی‌نوشت (The post scriptum)

پی‌نوشت حاوی مطالبی است که احتمالاً توسط اشخاص ثالث اضافه شده‌اند. این بخش امکان پیوست کردن برخی تبدیل‌ها (انتقال و بزرگ‌نمایی) را فراهم می‌کند. به طور معمول، شخصی فیلتر dvi به pdf را با گزینه‌های افست و بزرگ‌نمایی اعمال می‌کند، سپس همان گزینه‌ها را به پرونده synctex پیوست می‌کند، برای نمونه:

synctex update -o foo.pdf -m 0.486 -x 9472573sp -y 13.3dd source.dvi

• <Post Scriptum>::=
  • <byte offset record>
  • "Post Scriptum:" <EOL>
  • "Magnification:" <number> <EOL> (تنظیم بزرگ‌نمایی اضافی)
  • "X Offset:" <dimension> <EOL> (تنظیم افست افقی)
  • "Y Offset:" <dimension> <EOL> (تنظیم افست عمودی)

نحوه استفاده (USAGE)

رکورد <current record> برای محاسبه اندازه قابل مشاهده hboxها استفاده می‌شود. افست بایتی یک تکیه‌گاه ضمنی برای پیمایش پرونده synctex از برگه‌ای به برگه دیگر است. مختصات دوم یک نقطه فشرده با یک نویسه "=" جایگزین شده است که نشان می‌دهد این مختصات، مختصات دوم آخرین نقطه کامل موجود در سطرهای بالاست.

همچنین ببینید (SEE ALSO)

synctex(1) tex(1)

نویسندگان (AUTHOR)

فناوری همگام‌سازی تک (Synchronize TeXnology) اساساً توسط Jerome Laurens با پیشنهادهای مفید برخی از افراد سرشناس دنیای TeX توسعه یافته است. SyncTeX به عنوان بخشی از TeX Live نگهداری می‌شود.

تاریخچه (HISTORY)

این سند در Sat Apr 22 09:57:20 UTC 2017 برای گنجاندن پشتیبانی از \pdfxform به‌روزرسانی شده است.