Ascarya JaTs Editor
User Guide

🔎 Overview

Ascarya JaTs Editor is an all-in-one platform for academic manuscript processing. It consists of two main tools:

• Citation Hyperlinker — Automatically detects citations in your DOCX document, matches them to references, and inserts DOI hyperlinks via CrossRef.
• JATS XML Editor — Converts DOCX into JATS XML 1.3 ready for OJS, PubMed, and other academic databases, complete with a visual editor.

💻 System Requirements

👤 Creating an Account

1. Visit the homepage and click "Start Trial Account"
2. Fill in your name, email, and password on the registration form
3. Check your email and click the verification link
4. Once verified, you receive 2 free trials for Hyperlinker and 2 free trials for JATS Editor

📤 Uploading Files

After logging in, open the App page to start processing your manuscript.

How to Upload

• Drag & Drop — Drag your .docx file into the upload area
• Click to Browse — Click the upload area to select a file from your computer
• Multiple Files — You can upload multiple files at once for batch processing

⚙️ Configuration

Click the "⚙️ Configuration" panel to customize the processing settings.

▶️ Processing

After uploading the file and adjusting the configuration, click the "▶ Run Hyperlinker" button.

What Happens

1. Upload — The file is sent to the server
2. Parsing — The DOCX structure and references are read
3. Style Detection — The citation style is automatically detected
4. Citation Matching — In-text citations are matched to references
5. DOI Resolution — The CrossRef API searches for a DOI for each reference
6. Scholar Linking — Google Scholar fallback for references without a DOI
7. Hyperlink Insertion — Hyperlinks are inserted into the document
8. Finalize — The final document is saved

📊 Results & Download

Once processing is complete, you will see a results summary:

Displayed Information

• Total Links — Number of hyperlinks successfully inserted
• Style Used — The citation style detected/used
• Refs — Number of references found
• Citations — Number of citations successfully matched
• CrossRef — Number of DOIs successfully resolved
• Scholar — Number of Google Scholar links added
• Unmatched Refs — References that could not be matched

Action Buttons

📝 Supported Citation Styles

Ascarya supports 30+ international citation styles, grouped by format:

🧬 Opening the JATS Editor

The JATS Editor can be opened in two ways:

1. From Hyperlinker results — Click the "🧬 JaTs Editor" button on the processing results
2. Directly — Click the "🧬 JATS Editor" button on the App page, then import a DOCX file

After import, the document will be converted into a JATS XML structure and displayed in the visual editor.

📄 Front / Body / Back

A JATS XML document is divided into three main sections according to the JATS 1.3 standard:

Use the tabs in the toolbar to switch between sections, or select "All" to view everything at once.

🔧 Formatting Toolbar

Context Menus

• ✨ Import — Import a new DOCX file into the editor
• Heading ▾ — Change the heading level (H1–H6) or paragraph
• Insert Content ▾ — Insert a section, figure, table, formula, or video
• 🔗 Citation — Link selected text to a reference
• 📎 Cross-ref — Create a cross-reference to a figure/table/formula

Text Formatting

• B Bold · I Italic · U Underline · S Strikethrough
• X² Superscript · X₂ Subscript
• 🔗 Insert link · •≡ Bullet list · 1. Numbered list

📋 Metadata Panel

The metadata panel on the right side of the editor contains all the information required for valid JATS XML.

Metadata Sections

• General — Article type, DOI, ISSN, volume, issue, pages, language, UID
• Publisher — Publisher name, location, journal name
• Date — Date received, revised, accepted, published
• Permission — License (Creative Commons), copyright holder, copyright year
• Funding — Funding statement, open access funding

👥 Contributors

The Contributors panel manages authors, reviewers, and editors of the article:

• Authors — Add authors with name, email, affiliation, ORCID
• Reviewers — Add reviewers (optional)
• Editors — Add editors (optional)
• Correspondence — Select the corresponding author

📚 References

The References panel displays all references detected from the document. Features:

• Search — Search references by text
• DOI Badge — References with a DOI are marked with a blue badge
• Edit — Click a reference to edit its details
• Link Status — Link status for each reference (linked/unlinked)

📦 Exporting XML

Click the "Export XML" button in the editor top bar to export:

• JATS XML — An XML file conforming to the JATS 1.3 standard, ready to upload to OJS
• Preview — Preview the XML before downloading
• Save Draft — Save a draft to the server to continue later

⚠️ Warnings Panel

The Warnings panel displays automatic validation checks on the document:

• Cross-references to tables/figures that were not found
• Citations not linked to any reference
• Required metadata fields that have not been filled in
• Inconsistent heading structure

⌨️ Keyboard Shortcuts

❓ FAQ

Are my files safe?

Yes. Your files are processed on our server and automatically deleted after 24 hours. We do not store or share the contents of your documents.

How long does it take to process one file?

On average 30–90 seconds, depending on the number of references. Files with 50+ references may take longer due to DOI lookup via CrossRef.

Why are there "unmatched refs"?

Unmatched references typically occur because: (1) Inconsistent citation formatting within the document, (2) References that are not cited in the body text, or (3) References from non-standard sources (legislation, websites, etc.).

What citation formats are supported?

30+ international citation styles including APA, Chicago, IEEE, Vancouver, Harvard, MLA, OSCOLA, Turabian, Bluebook, and more. See the Citation Styles section for the full list.

How do I purchase quota?

Contact us via email admin@ascarya.or.id to purchase a package.

Can it be used for non-OJS journals?

Yes. The generated JATS XML follows the international JATS 1.3 standard and is compatible with OJS, PubMed, Crossref, and other systems that support JATS.

📧 Contact & Support

For bug reports, technical questions, or feature requests, please contact us via email.