### Full MathJax Node.js Initialization and Conversion Example Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md A complete example demonstrating MathJax initialization in Node.js, including loader configuration for TeX input and SVG output. It shows how to convert a TeX string to SVG and print the resulting HTML, with basic error handling. ```javascript require('mathjax').init({ loader: {load: ['input/tex', 'output/svg']} }).then((MathJax) => { const svg = MathJax.tex2svg('\\frac{1}{x^2-1}', {display: true}); console.log(MathJax.startup.adaptor.outerHTML(svg)); }).catch((err) => console.log(err.message)); ``` -------------------------------- ### Host MathJax Components with npm Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md Instructions to install MathJax using npm and move the 'es5' directory to a server location for self-hosting. It specifies using '@3' for version 3 to ensure compatibility. ```bash npm install mathjax@3 mv node_modules/mathjax/es5 /mathjax ``` -------------------------------- ### Install draw.io Image Resizer Dependencies Source: https://github.com/jgraph/drawio/blob/dev/etc/imageResize/README.md Installs the necessary Node.js packages required for the draw.io image resizing script to function. ```Shell npm install ``` -------------------------------- ### draw.io Configuration Space Setup (Confluence) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Explains the necessity of the DRAWIOCONFIG space in Confluence for storing draw.io configuration files, custom libraries, and templates, and how to create it. ```APIDOC draw.io Configuration Space (DRAWIOCONFIG): Purpose: Required to store draw.io configuration files and custom libraries/templates. Action: Create Config Space if it does not exist. ``` -------------------------------- ### Install MathJax for Node.js Applications Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md Instructions to install the 'mathjax' package using npm for use within a Node.js application. It is recommended to install version 3 specifically. ```bash npm install mathjax@3 ``` -------------------------------- ### draw.io Configuration and Migration Notices Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_te.txt Important warnings and instructions for configuring draw.io, especially during Confluence Cloud migration and general setup. ```APIDOC Configuration_and_Migration: confAReplaceBaseUrl: "Replace Base URL in diagram links when no page ID mapping is found." confCloudMigConfirm: "Warning: This process will edit many pages and diagrams, so it is recommended to stop the Synchrony service during the process. Do you want to proceed?" confCloudMigNotice: "In the Cloud instance, please add linkAdjustments to draw.io configuration as follows {1}. Without this configuration, links in diagrams pointing to Confluence pages will not work." confALogsPageDesc: "This page contains logs of draw.io long running services as attachments." confConfigSpacePerm: "Note: If you recently migrated from DC app, please check draw.io Configuration space permissions such that all users can read and only admins can write. In addition, remove the page restrictions on "Configuration" and "Libraries" pages. You may need admin keys to access them. Also, please check the file "configuration.json" in the "Configuration" page is downloadable." ``` -------------------------------- ### draw.io Google Drive App Installation Required Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Informs the user that the draw.io Google Drive application is not installed and must be installed before proceeding with file access. ```English draw.io Google Drive app is not installed, please install it first ``` -------------------------------- ### draw.io Diagrams Re-indexing (Beta) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_bn.txt Describes the beta feature for refreshing the draw.io diagrams index, initiated by a 'Start Indexing' action. ```APIDOC drawioReindexing (Beta): Purpose: Refresh draw.io diagrams index. Action: Click "Start Indexing" button. ``` -------------------------------- ### Confluence Cloud Migration/Operation Error Troubleshooting Guide Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_fa.txt Provides general guidance for troubleshooting errors encountered during draw.io operations or Confluence Cloud migration, suggesting log download for further reference. ```APIDOC Error Troubleshooting Guide: confAErrFaqs: There are {1} error(s), the following instructions may help fixing most of the cases. (Please download the log for future references) ``` -------------------------------- ### Load MathJax from CDN in HTML Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md This snippet demonstrates how to include the MathJax library in an HTML web page by loading it asynchronously from a CDN. This method requires no local installation and ensures the latest version of MathJax is used to render mathematical notation. ```HTML ``` -------------------------------- ### API Error Handling Overview (draw.io) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_pt.txt Provides a general overview of error reporting within draw.io, suggesting troubleshooting steps and log downloads for various issues. This snippet serves as a guide for initial error diagnosis. ```APIDOC Error Type: General Errors Description: There are {1} error(s), the following instructions may help fixing most of the cases. (Please download the log for future references) ``` -------------------------------- ### Google Drive Integration Messages Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hr.txt Messages related to the draw.io integration with Google Drive. These inform users about initial access requirements and the necessity of having the draw.io Google Drive application installed. ```English firstTimeGD=First time to access this file? ``` ```English drawioGDAppNotInstalled=draw.io Google Drive app is not installed, please install it first ``` -------------------------------- ### HTTP Specific Error Message Explanations Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hr.txt Provides detailed explanations for common HTTP error codes (403, 404, 500) encountered within the Confluence integration. These messages guide users on potential causes and solutions for each specific error type. ```English confA403ErrFaq=There are ({1}) 403 error(s). The current users must have add (write) permissions on all pages and attachments. Even admins sometimes are not allowed to write to some pages via page restrictions ``` ```English confA404ErrFaq=There are ({1}) 404 error(s). The attachment/page is not found. This is due to improper migration or the diagram file (an attachment of the page) is deleted. ``` ```English confA500ErrFaq=There are ({1}) 500 error(s). An internal server error in Confluence Cloud. Such errors are due to overloading the server and usually fixed by retrying the process. ``` -------------------------------- ### Google Drive Integration Messages Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_si.txt Messages related to draw.io's integration with Google Drive, specifically concerning initial file access and app installation requirements. ```Properties firstTimeGD=First time to access this file? ``` ```Properties drawioGDAppNotInstalled=draw.io Google Drive app is not installed, please install it first ``` -------------------------------- ### MathJax Bug Report Template Structure Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/CONTRIBUTING.md This template provides a structured format for submitting bug reports to the MathJax project. It guides users to include a concise summary, steps to reproduce the issue, and technical details about their environment. This helps maintainers efficiently understand and address reported problems. ```Markdown Short and descriptive example bug report title ### Issue Summary A summary of the issue and the browser/OS environment in which it occurs. If suitable, include the steps required to reproduce the bug. ``` -------------------------------- ### draw.io Office Integration: Workflow Steps and Manual Instructions Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt Outlines the add-in's operational steps and provides specific manual instructions for users, such as copying and pasting diagrams or images when automated insertion is not possible. ```APIDOC officeMainHeader: Adds draw.io diagrams to your document. officeStepsHeader: This add-in performs the following steps: - officeStep1: Connects to Microsoft OneDrive, Google Drive or your device. - officeStep2: Select a draw.io diagram. - officeStep3: Insert the diagram into the document. officeCopyImgInst: Instructions: Right-click the image below. Select "Copy image" from the context menu. Then, in the document, right-click and select "Paste" from the context menu. officeManualUpdateInst: Instructions: Copy draw.io diagram from the document. Then, in the box below, right-click and select "Paste" from the context menu. ``` -------------------------------- ### JSON Configuration Instructions Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Provides guidance on how to apply draw.io JSON configuration using the editor. ```APIDOC draw.io JSON Configuration: Instructions: - Write draw.io JSON configuration in the editor below. - Click save. - For help, refer to this page. ``` -------------------------------- ### Confluence Cloud Migration and Configuration Guidance Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hr.txt Provides critical warnings and instructions for administrators regarding Confluence Cloud migration. This includes recommendations for service management during migration and necessary configuration adjustments to ensure diagram links function correctly post-migration, along with advice on space permissions. ```English confCloudMigConfirm=Warning: This process will edit many pages and diagrams, so it is recommended to stop the Synchrony service during the process. Do you want to proceed? ``` ```English confCloudMigNotice=In the Cloud instance, please add linkAdjustments to draw.io configuration as follows {1}. Without this configuration, links in diagrams pointing to Confluence pages will not work. ``` ```English confALogsPageDesc=This page contains logs of draw.io long running services as attachments ``` ```English confConfigSpacePerm=Note: If you recently migrated from DC app, please check draw.io Configuration space permissions such that all users can read and only admins can write. In addition, remove the page restrictions on "Configuration" and "Libraries" pages. You may need admin keys to access them. Also, please check the file "configuration.json" in the "Configuration" page is downloadable. ``` -------------------------------- ### Confluence Migration and Configuration Guidance Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_si.txt These messages provide important warnings and instructions for administrators regarding Confluence Cloud migration, necessary configuration adjustments, and permission settings for draw.io. ```Properties confCloudMigConfirm=Warning: This process will edit many pages and diagrams, so it is recommended to stop the Synchrony service during the process. Do you want to proceed? ``` ```Properties confCloudMigNotice=In the Cloud instance, please add linkAdjustments to draw.io configuration as follows {1}. Without this configuration, links in diagrams pointing to Confluence pages will not work. ``` ```Properties confALogsPageDesc=This page contains logs of draw.io long running services as attachments ``` ```Properties confConfigSpacePerm=Note: If you recently migrated from DC app, please check draw.io Configuration space permissions such that all users can read and only admins can write. In addition, remove the page restrictions on "Configuration" and "Libraries" pages. You may need admin keys to access them. Also, please check the file "configuration.json" in the "Configuration" page is downloadable. ``` -------------------------------- ### Initialize MathJax in Node.js Application Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md Shows the basic structure for requiring and initializing MathJax in a Node.js application. It highlights placeholders for MathJax configuration and the code to run after MathJax has been loaded. ```javascript require('mathjax').init({ ... }).then((MathJax) => { ... }); ``` -------------------------------- ### General Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Provides a general message about multiple errors and suggests downloading logs for future reference to help fix most cases. ```English There are {1} error(s), the following instructions may help fixing most of the cases. (Please download the log for future references) ``` -------------------------------- ### Host MathJax Components via GitHub Clone Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md Alternative method to obtain MathJax files by cloning the GitHub repository and moving the 'es5' directory to the server. This snippet includes cleanup of temporary files after the move. ```bash git clone https://github.com/mathjax/MathJax.git mj-tmp mv mj-tmp/es5 /mathjax rm -rf mj-tmp ``` -------------------------------- ### Confluence Configuration Space Permissions Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Provides detailed instructions for configuring draw.io space permissions after migrating from the DC app. This includes setting read/write access for users and admins, removing page restrictions on 'Configuration' and 'Libraries' pages, and verifying the downloadability of 'configuration.json'. ```English Note: If you recently migrated from DC app, please check draw.io Configuration space permissions such that all users can read and only admins can write. In addition, remove the page restrictions on "Configuration" and "Libraries" pages. You may need admin keys to access them. Also, please check the file "configuration.json" in the "Configuration" page is downloadable. ``` -------------------------------- ### draw.io Office Add-in Workflow Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Describes the high-level steps performed by the draw.io add-in for Microsoft Office applications to insert diagrams into documents. ```APIDOC Office Add-in Workflow: 1. Connects to Microsoft OneDrive, Google Drive or your device. 2. Select a draw.io diagram. 3. Insert the diagram into the document. ``` -------------------------------- ### draw.io Configuration Space Management (Confluence) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_bn.txt Details the requirement for a dedicated Confluence Space (DRAWIOCONFIG) to store draw.io configuration files, custom libraries, and templates, and how to create it if missing. ```APIDOC ConfigurationSpace: Name: DRAWIOCONFIG Purpose: Storage for draw.io configuration files, custom libraries, and templates. Status: - IfNotFound: "Create Config Space" action available. ConfigurationMethod: - Type: JSON - Location: Editor within the application. - Reference: External documentation ("this page"). ``` -------------------------------- ### draw.io Office Add-in Core Functionality Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_bn.txt Describes the main steps performed by the draw.io add-in for Microsoft Office applications, including connecting to cloud storage and inserting diagrams. ```APIDOC OfficeAddin: Description: Adds draw.io diagrams to your document. Workflow: - ConnectsTo: [Microsoft OneDrive, Google Drive, Local Device] - Action: Select draw.io diagram - Result: Insert diagram into document ``` -------------------------------- ### General draw.io System Messages and Warnings Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_te.txt Miscellaneous messages including evaluation license warnings, Google Drive access issues, and preview generation errors. ```APIDOC General_System_Messages: drawSvgPrev: "draw.io SVG preview" googleFonts: "Google Fonts" confEvalWarn: "Evaluation License - Not for production use." firstTimeGD: "First time to access this file?" drawioGDAppNotInstalled: "draw.io Google Drive app is not installed, please install it first." ConfDC415Error: "Saving drafts is blocked. If you have "Attachment Checker for Confluence" app, please update to the latest version." remove: "Remove" selectPgLyr: "Select Page and Layers" errGenPreview: "There was an error generating a diagram preview. Please consult technical support." attAccessErr: "Diagram attachment access error: cannot display diagram." widthIntOrFixed: "Width must be a valid integer or of value 'fixed'." ``` -------------------------------- ### Evaluation License Warning Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Informs users that the current license is for evaluation purposes only and is not intended for use in a production environment. ```English Evaluation License - Not for production use ``` -------------------------------- ### First Time Google Drive File Access Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt A prompt or message indicating that the user is attempting to access a specific file in Google Drive for the first time. ```English First time to access this file? ``` -------------------------------- ### Select Page and Layers Option Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Refers to a feature or option that allows users to select specific pages and layers within a diagram. ```English Select Page and Layers ``` -------------------------------- ### draw.io Re-indexing Feature Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Explains how to refresh the draw.io diagrams index, noting its beta status. ```APIDOC draw.io Re-indexing (beta): Action: Click the "Start Indexing" button to refresh draw.io diagrams index. ``` -------------------------------- ### Custom Libraries Management Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Describes how to manage custom libraries within draw.io, including viewing current libraries and adding new ones. ```APIDOC Custom Libraries: Current Custom Libraries: [List of libraries] Action: Add Library (upload a new library) ``` -------------------------------- ### MathJax Git Branching Strategy Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/CONTRIBUTING.md Describes the permanent branches used in the MathJax source and distribution repositories, their purpose, and recommended usage for development and production. It also mentions the use of Git tags for version identification. ```APIDOC MathJax Source Repository (MathJax-src): - develop: Purpose: Development branch for the next release. Usage: Branch off for pull requests. Warning: Do NOT use for production. - master: Purpose: Contains the latest release of MathJax. Usage: May be used in production. Warning: Do NOT use for source work. MathJax Distribution Repository (MathJax): - legacy-v2-develop: Purpose: Development branch for changes to legacy version 2 code. Usage: Branch off for version 2 pull requests. Warning: Do NOT use for production. - legacy-v2: Purpose: Contains any updates to version 2 following the release of version 3. Usage: Do NOT use this branch to work on MathJax's source. Tags: Purpose: Identify various versions. Usage: `git checkout ` (e.g., `git checkout 2.7.5`) ``` -------------------------------- ### 404 Not Found Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Describes the reason for 404 errors, indicating that the attachment or page is not found. This can be caused by improper migration or the deletion of the diagram file. ```English There are ({1}) 404 error(s). The attachment/page is not found. This is due to improper migration or the diagram file (an attachment of the page) is deleted. ``` -------------------------------- ### Rebuild MathJax ES5 Components Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md Command to rebuild the 'es5' directory from the MathJax source repository. This is primarily for developers who need to generate the component files from source. ```bash npm run make-es5 --silent ``` -------------------------------- ### Configuration: Confluence Cloud Link Adjustments (draw.io) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_pt.txt Outlines a critical configuration requirement for draw.io in Confluence Cloud instances. Adding 'linkAdjustments' is necessary to ensure that internal links within diagrams correctly point to Confluence pages. ```APIDOC Configuration Item: linkAdjustments Applicability: Confluence Cloud instances Purpose: Ensure links in diagrams pointing to Confluence pages work. Instruction: Add to draw.io configuration as specified by placeholder {1}. ``` -------------------------------- ### draw.io Confluence Integration: General Messages and Errors Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt Lists common messages and error conditions specific to the draw.io integration with Confluence Cloud, covering issues like timeouts, page ID retrieval, and external editing conflicts. ```APIDOC confluenceCloud: Confluence Cloud libraries: Libraries confAnchor: Confluence Page Anchor confTimeout: The connection has timed out confSrvTakeTooLong: The server at {1} is taking too long to respond. confCannotInsertNew: Cannot insert draw.io diagram to a new Confluence page confSaveTry: Please save the page and try again. confCannotGetID: Unable to determine page ID confContactAdmin: Please contact your Confluence administrator. readErr: Read Error editingErr: Editing Error confExtEditNotPossible: This diagram cannot be edited externally. Please try editing it while editing the page confEditedExt: Diagram/Page edited externally diagNotFound: Diagram Not Found confEditedExtRefresh: Diagram/Page is edited externally. Please refresh the page. confCannotEditDraftDelOrExt: Cannot edit diagrams in a draft page, diagram is deleted from the page, or diagram is edited externally. Please check the page. retBack: Return back confDiagNotPublished: The diagram does not belong to a published page createdByDraw: Created by draw.io invalidCallFnNotFound: Invalid Call: {1} not found invalidCallErrOccured: Invalid Call: An error occurred, {1} anonymous: Anonymous confGotoPage: Go to containing page confError: Error: {1} ``` -------------------------------- ### Other Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Advises users to check the error description for other types of errors. If the description is unclear, users are encouraged to contact support for assistance. ```English There are ({1}) other error(s). Please check the error description. If the description is not clear, please contact our support. ``` -------------------------------- ### General UI Labels and Warnings Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hr.txt Miscellaneous user interface labels and general warnings. This includes options for replacing base URLs, preview settings, font integration, and validation messages for input fields, along with evaluation license warnings. ```English confAReplaceBaseUrl=Replace Base URL in diagram links when no page ID mapping is found ``` ```English drawSvgPrev=draw.io SVG preview ``` ```English googleFonts=Google Fonts ``` ```English remove=Remove ``` ```English selectPgLyr=Select Page and Layers ``` ```English confEvalWarn=Evaluation License - Not for production use ``` ```English widthIntOrFixed=Width must be a valid integer or of value 'fixed' ``` -------------------------------- ### Diagram Preview Generation Error Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Reports an issue encountered while attempting to generate a preview of a diagram. Users are advised to contact technical support for assistance. ```English There was an error generating a diagram preview. Please consult technical support. ``` -------------------------------- ### draw.io Office Integration: Core Functionality and UI Messages Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt This section covers essential user interface messages and prompts related to the draw.io add-in for Microsoft Office, including diagram selection, authentication, and general operational statuses. ```APIDOC officeSelectDiag: Please select a draw.io diagram. officeCannotFindDiagram: Cannot find a draw.io diagram in the selection noDiagrams: No diagrams found folderEmpty: Folder is empty recent: Recent sharedWithMe: Shared With Me sharepointSites: Sharepoint Sites officeSelDiag: Select draw.io Diagram: files: Files shared: Shared sharepoint: Sharepoint officeClickToEdit: Click icon to start editing: pasteDiagram: Paste draw.io diagram here connectOD: Connect to OneDrive ``` -------------------------------- ### Confluence Integration Error Messages and FAQs Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_si.txt These snippets define various error messages and frequently asked questions displayed to users when issues arise during draw.io's integration with Confluence, including HTTP status code errors (403, 404, 500) and general error handling guidance. ```Properties confAErrFaqs=There are {1} error(s), the following instructions may help fixing most of the cases. (Please download the log for future references) ``` ```Properties confA403ErrFaq=There are ({1}) 403 error(s). The current users must have add (write) permissions on all pages and attachments. Even admins sometimes are not allowed to write to some pages via page restrictions ``` ```Properties confA404ErrFaq=There are ({1}) 404 error(s). The attachment/page is not found. This is due to improper migration or the diagram file (an attachment of the page) is deleted. ``` ```Properties confA500ErrFaq=There are ({1}) 500 error(s). An internal server error in Confluence Cloud. Such errors are due to overloading the server and usually fixed by retrying the process. ``` ```Properties confAOtherErrFaq=There are ({1}) other error(s). Please check the error description. If the description is not clear, please contact our support. ``` ```Properties ConfDC415Error=Saving drafts is blocked. If you have "Attachment Checker for Confluence" app, please update to the latest version. ``` ```Properties attAccessErr=Diagram attachment access error: cannot display diagram ``` -------------------------------- ### Gliffy Diagram Import Feature Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_bn.txt Explains the process for importing Gliffy diagrams into draw.io, noting the time required and browser window requirements for successful completion. ```APIDOC GliffyImportFeature: Purpose: Imports all Gliffy diagrams to draw.io. Method: Start Import Constraints: - Duration: Takes some time. - UserInteraction: Browser window must remain open until completion. ``` -------------------------------- ### General User Interface and System Messages Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_si.txt Miscellaneous messages covering general UI labels, warnings, and system-level information not categorized elsewhere, providing context for various application functionalities. ```Properties drawSvgPrev=draw.io SVG preview ``` ```Properties googleFonts=Google Fonts ``` ```Properties remove=Remove ``` ```Properties selectPgLyr=Select Page and Layers ``` ```Properties errGenPreview=There was an error generating a diagram preview. Please consult technical support. ``` ```Properties widthIntOrFixed=Width must be a valid integer or of value 'fixed' ``` ```Properties confEvalWarn=Evaluation License - Not for production use ``` ```Properties otherUsersEditing=Other user(s) are editing this diagram ``` ```Properties confAReplaceBaseUrl=Replace Base URL in diagram links when no page ID mapping is found ``` -------------------------------- ### Gliffy Import Feature Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Details the process for importing Gliffy diagrams into draw.io, including user interaction and important considerations during the import procedure. ```APIDOC Gliffy Import: Instructions: - Click the "Start Import" button to import all Gliffy diagrams to draw.io. - Note: The import procedure will take some time and the browser window must remain open until the import is completed. ``` -------------------------------- ### Diagram Duplication Failure - Try Later Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Advises the user that the attempt to duplicate the diagram was unsuccessful and suggests trying again at a later time. ```English Could not duplicate diagram. Please try again later. ``` -------------------------------- ### Confluence Integration Error FAQs Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_te.txt Explanations for common error codes encountered during draw.io operations within Confluence, including 403 (permission), 404 (not found), 500 (internal server), and general errors. ```APIDOC Error_FAQs: confAErrFaqs: "General error message indicating {1} errors. Download logs for reference." confA403ErrFaq: "403 Forbidden Error: {1} occurrences. Requires add (write) permissions on pages and attachments. Page restrictions can affect even admins." confA404ErrFaq: "404 Not Found Error: {1} occurrences. Attachment/page not found due to improper migration or deleted diagram file." confA500ErrFaq: "500 Internal Server Error: {1} occurrences. Confluence Cloud internal server error, often due to overloading. Usually fixed by retrying." confAOtherErrFaq: "Other Errors: {1} occurrences. Check error description. Contact support if unclear." ``` -------------------------------- ### draw.io SVG Preview Feature Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Refers to the functionality within draw.io that allows for the preview of diagrams in SVG format. ```English draw.io SVG preview ``` -------------------------------- ### Confluence Cloud Migration Link Adjustment Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Provides a critical configuration notice for Confluence Cloud instances. It advises adding 'linkAdjustments' to the draw.io configuration to ensure that links within diagrams pointing to Confluence pages function correctly. ```English In the Cloud instance, please add linkAdjustments to draw.io configuration as follows {1}. Without this configuration, links in diagrams pointing to Confluence pages will not work. ``` -------------------------------- ### draw.io Confluence Integration: Draft and File Management Errors Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt Details error messages related to saving, loading, and managing diagrams within Confluence draft pages, including issues with duplicate names, session expiration, and invalid file properties. ```APIDOC filenameShort: Filename too short invalidChars: Invalid characters alreadyExst: {1} already exists draftReadErr: Draft Read Error di ``` -------------------------------- ### Other Confluence Cloud Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_fa.txt Provides general advice for other types of errors encountered during draw.io operations in Confluence Cloud, recommending checking the error description or contacting support. ```APIDOC Other Errors: confAOtherErrFaq: There are ({1}) other error(s). Please check the error description. If the description is not clear, please contact our support. ``` -------------------------------- ### Include Hosted MathJax in HTML Script Tag Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/math/README.md Demonstrates how to include the self-hosted MathJax components in an HTML page using a script tag. The 'src' attribute should be replaced with the URL to the location where MathJax files are hosted on your server. ```html ``` -------------------------------- ### Handle OneDrive Authentication Callback (JavaScript) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/onedrive3.html This block checks if the script is running in a popup opened by another window and if a OneDrive callback function (`onOneDriveCallback`) is available on the opener. It then calls `getAuthInfoFromUrl()` to retrieve the access token and passes it to the opener's callback, handling potential errors by displaying an alert and closing the window. ```javascript if (window.opener != null && window.opener.onOneDriveCallback != null) { try { var authInfo = getAuthInfoFromUrl(); var token = authInfo['access_token']; window.opener.onOneDriveCallback(token, window); } catch (e) { alert('OneDrive: ' + e.toString()); window.close(); } } ``` -------------------------------- ### Custom Templates Management Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Outlines how custom templates are managed in draw.io, specifically their storage location within Confluence pages. ```APIDOC Custom Templates: Storage: draw.io diagrams saved in children pages of the Templates page. Reference: For more details, refer to the Templates page. ``` -------------------------------- ### draw.io Diagram Element Selection Options Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt Describes the various options available for selecting related elements within a draw.io diagram, facilitating navigation and manipulation of diagram components. ```APIDOC selectChildren: Select Children selectSiblings: Select Siblings selectParent: Select Parent selectDescendants: Select Descendants ``` -------------------------------- ### Confluence Cloud Migration Warning Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Warns users about a migration process that will modify numerous pages and diagrams. It strongly recommends stopping the Synchrony service during this process to prevent issues. ```English Warning: This process will edit many pages and diagrams, so it is recommended to stop the Synchrony service during the process. Do you want to proceed? ``` -------------------------------- ### Confluence Cloud 403 Forbidden Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_fa.txt Explains the cause of 403 Forbidden errors (insufficient write permissions) during draw.io operations in Confluence Cloud and suggests checking user permissions. ```APIDOC HTTP 403 Forbidden Error: confA403ErrFaq: There are ({1}) 403 error(s). The current users must have add (write) permissions on all pages and attachments. Even admins sometimes are not allowed to write to some pages via page restrictions ``` -------------------------------- ### Handle GitHub OAuth Callback in JavaScript Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/github.html This JavaScript snippet processes a GitHub OAuth callback. It checks if a parent window (window.opener) exists and has an 'onGitHubCallback' function. It extracts a 'code' parameter from the current window's URL query string and passes it to the parent window's callback. Includes error handling to alert issues and close the window. ```JavaScript if (window.opener != null && window.opener.onGitHubCallback != null) { try { var search = window.location.search; var idx1 = search.indexOf('code='); var code = null; if (idx1 >= 0) { code = search.substring(idx1 + 5); } // Continues execution of main program flow window.opener.onGitHubCallback(code, window); } catch (e) { alert('GitHub: ' + e.toString()); window.close(); } } ``` -------------------------------- ### Confluence Cloud 404 Not Found Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_fa.txt Explains the cause of 404 Not Found errors (missing attachment/page) during draw.io operations in Confluence Cloud, often due to improper migration or deleted files. ```APIDOC HTTP 404 Not Found Error: confA404ErrFaq: There are ({1}) 404 error(s). The attachment/page is not found. This is due to improper migration or the diagram file (an attachment of the page) is deleted. ``` -------------------------------- ### CSS for Adaptive Assets and Body Styling Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/clear.html Defines styles for adaptive assets (e.g., images) to invert colors in dark mode and sets global body styles including font family, background, text color, color scheme, and font size. ```CSS @media (prefers-color-scheme: dark) { .adaptive-asset { filter: invert(1); } } body { font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; background: light-dark(rgb(255, 255, 255), rgb(18, 18, 18)); color: light-dark(rgb(18, 18, 18), white); color-scheme: light dark; font-size: 12px; } ``` -------------------------------- ### Edit Diagram From Owning Page Prompt Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Prompts the user to open the diagram's owning page for editing. This is because the diagram can only be modified from its original source page. ```English Diagram can only be edited from the page that owns it. Would you like to open the owning page for edit? ``` -------------------------------- ### Diagram Duplication Failure - Owning Page Access Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Indicates that the diagram duplication process failed due to restrictions on accessing the diagram's owning page. ```English Owning page access restriction: cannot duplicate diagram. ``` -------------------------------- ### Confluence draw.io Logs Page Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Describes a dedicated page within Confluence that serves as a repository for logs generated by draw.io's long-running services, stored as page attachments. ```English This page contains logs of draw.io long running services as attachments ``` -------------------------------- ### 403 Forbidden Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Explains the cause of 403 errors, which are typically due to insufficient write permissions on pages and attachments, even for administrators with page restrictions. ```English There are ({1}) 403 error(s). The current users must have add (write) permissions on all pages and attachments. Even admins sometimes are not allowed to write to some pages via page restrictions ``` -------------------------------- ### draw.io Diagram Commenting and Resolution Features Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt Details the messages and actions related to the commenting and resolution system within draw.io, including status updates, timestamps, and comment visibility. ```APIDOC lastSaved: Last saved {1} ago resolve: Resolve reopen: Re-open showResolved: Show Resolved reply: Reply objectNotFound: Object not found reOpened: Re-opened markedAsResolved: Marked as resolved noCommentsFound: No comments found comments: Comments timeAgo: {1} ago showComments: Show Comments ``` -------------------------------- ### CSS for Button Styling and Interactions Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/clear.html Defines base styles for buttons including background color (adapting to light/dark mode), border radius, padding, and no border. It also specifies cursor behavior, opacity for default and hover states, and an invert filter for active states. ```CSS button { background: light-dark(#29b6f2, #003555); border-radius: 4px; padding: 10px; border: none; } button { cursor: default; opacity: 0.9; } button:hover:not(:disabled) { opacity: 1; } button:active:not(:disabled) { filter:invert(1); } ``` -------------------------------- ### Custom Libraries Management Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_bn.txt Describes the functionality for managing custom draw.io libraries, including viewing current libraries and adding new ones through an upload process. ```APIDOC CustomLibraries: Purpose: Manage custom draw.io libraries. Features: - ViewCurrentLibraries: Displays Library Name, Action, draw.io Config ID. - AddNewLibrary: "Add Library" button to upload a new library. ``` -------------------------------- ### draw.io Office Integration: Error and Authentication Messages Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_ja.txt Details various error messages and authentication-related notifications that users might encounter when using the draw.io add-in within Microsoft Office, including issues with authorization, file fetching, and image insertion. ```APIDOC authFailed: Authentication failed officeFailedAuthMsg: Unable to successfully authenticate user or authorize application. convertingDiagramFailed: Converting diagram failed officeCopyImgErrMsg: Due to some limitations in the host application, the image could not be inserted. Please manually copy the image then paste it to the document. insertingImageFailed: Inserting image failed errorFetchingFolder: Error fetching folder items errorAuthOD: Error authenticating to OneDrive officeAuthPopupInfo: Please complete the authentication in the pop-up window. ``` -------------------------------- ### Page IDs Export Feature Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_sl.txt Details the process for exporting all page IDs from draw.io, including user interaction and important considerations during the export procedure. ```APIDOC Page IDs Export: Instructions: - Select export target. - Click the "Start Export" button to export all pages IDs. - Note: The export procedure will take some time and the browser window must remain open until the export is completed. ``` -------------------------------- ### Confluence DC 415 Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Explains that saving drafts is blocked due to a 415 error. It suggests updating the 'Attachment Checker for Confluence' app to its latest version as a potential fix. ```English Saving drafts is blocked. If you have "Attachment Checker for Confluence" app, please update to the latest version. ``` -------------------------------- ### Replace Base URL in Diagram Links Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Describes a configuration option or process to replace the base URL in diagram links. This action is performed when no corresponding page ID mapping is found. ```English Replace Base URL in diagram links when no page ID mapping is found ``` -------------------------------- ### Confluence Cloud 500 Internal Server Error Troubleshooting Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_fa.txt Explains the cause of 500 Internal Server errors (server overloading) in Confluence Cloud during draw.io operations, suggesting retrying the process. ```APIDOC HTTP 500 Internal Server Error: confA500ErrFaq: There are ({1}) 500 error(s). An internal server error in Confluence Cloud. Such errors are due to overloading the server and usually fixed by retrying the process. ``` -------------------------------- ### Diagram Duplication Disabled with Page/Layer Selection Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Explains that the functionality to duplicate a diagram is unavailable when specific pages and layers are currently selected. ```English Diagram duplication is disabled when page and layers are selected ``` -------------------------------- ### Handle Dropbox OAuth Callback and Token Extraction in JavaScript Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/dropbox.html This JavaScript snippet processes the URL hash after a Dropbox OAuth redirect. It checks for the 'access_token' parameter, extracts its value, and then calls a function 'onDropboxCallback' on the parent window (opener) to pass the token and the current window object. Includes basic error handling to alert the user and close the window if an error occurs during the process. ```javascript if (window.opener != null && window.opener.onDropboxCallback != null) { try { var hash = window.location.hash; var i1 = hash.indexOf('access_token='); var token = null; if (i1 >= 0) { var i2 = hash.indexOf('&', i1 + 13); if (i2 > i1) { token = hash.substring(i1 + 13, i2); } } // Continues execution of main program flow window.opener.onDropboxCallback(token, window); } catch (e) { alert('Dropbox: ' + e.toString()); window.close(); } } ``` -------------------------------- ### Handle Duplicate Diagram Detection Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hi.txt Explains that a diagram used in multiple places can lead to unexpected results. When detected, an independent copy is created for editing, or editing is restricted to the diagram's own page. ```English Duplicate Diagram Detected This diagram is used in multiple places, which can result in unexpected results when edited. We've created an independent copy. Please open the editor again. This diagram is used in multiple places. Please edit it within its own page. ``` -------------------------------- ### API Error: 404 Not Found (draw.io Attachments) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_pt.txt Explains the 404 Not Found error, typically occurring when diagram attachments or their associated Confluence pages are missing. This often results from improper migrations or accidental file deletions. ```APIDOC Error Code: 404 Not Found Cause: Attachment/page not found. Context: Improper migration or diagram file (attachment) deleted. Resolution: Verify existence of diagram files and associated pages. ``` -------------------------------- ### Draw.io Application Localization (Hebrew) Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_he.txt A collection of key-value pairs representing the user interface and application messages translated into Hebrew for Draw.io. Each line maps an English key to its Hebrew equivalent, used for internationalization. ```Properties about=אודות aboutDrawio=אודות Draw.io accessDenied=הגישה דחתה accounts=Accounts action=פעולה actualSize=גודל אמיתי adaptiveColors=צבעים מסתגלים add=הוסף addAccount=הוסף חשבון addedFile=נוסף {1} addImages=הוסף תמונות addImageUrl=הוסף קישור לתמונה addLayer=הוסף שכבה addProperty=הוסף מאפיין address=כתובת addToExistingDrawing=הוסף לסקיצה קיימת addToScratchpad=Add to Scratchpad addWaypoint=הוסף נקודת ציון adjustTo=התאם ל advanced=מתקדם smartTemplate=Smart Template align=ישר alignment=יישור allChangesLost=כל השינויים יאבד! allPages=כל הדפים allProjects=כל הפרויקטים allSpaces=כל הרווחים allTags=כל התגיות anchor=עוגן android=אנדרואיד angle=זווית animations=אנימציות arc=קשת areYouSure=האם אתה בטוח? ensureDataSaved=אנא וודא ששמרת את המידע לפני סגירה. allChangesSaved=כל השינויים נשמרו allChangesSavedInDrive=כל השינויים נשמרו בכונן allowPopups=אפשר חלונות קופצים כדי להימנע מדיאלוג זה allowRelativeUrl=אפשר URL יחסי alreadyConnected=הנקודות כבר מחוברות appearance=Appearance apply=החל archiMate21=ArchiMate 2.1 arrange=ארגן arrow=חץ arrows=חצים askMeAnything=Ask me anything asNew=כחדש atlas=אטלס author=מחבר authorizationRequired=נדרשת הרשאה authorizeThisAppIn=תן הרשאה ליישום זה ב-{1}: authorize=תן הרשאה authorizing=נותן הרשאה automatic=אוטומטי autosave=שמירה אוטומטי autosize=גודל אוטומטי attachments=קבצים מצורפים aws=AWS aws3d=AWS 3D azure=Azure back=חזרה background=רקע backgroundColor=צבע רקע backgroundImage=תמונת רקע basic=בסיסי beta=beta blankDrawing=סקיצה ריקה blankDiagram=דיאגרמה ריקה block=בלוק blockquote=בלוק ציטוט blog=בלוג bold=מודגש bootstrap=Bootstrap border=Border borderColor=צבע גבול borderWidth=רוחב גבול bottom=תחתית bottomAlign=ישר למטה bottomLeft=שמאל למטה bottomRight=ימין למטה bpmn=BPMN bringForward=Bring Forward browser=דפדפן bulletedList=רשימת בולטים business=עסקים busy=הפעולה מתבצעת cabinets=ארוניות cancel=בטל center=מרכז cannotLoad=ניסיונות הטעינה נכשלו. אנא נסה שוב מאוחר יותר. cannotLogin=ניסיונות ההתחברות נכשלו. אנא נסה שוב מאוחר יותר. cannotOpenFile=לא ניתן לפתוח את הקובץ change=שנה changeOrientation=שנה אוריינטציה changeUser=שנה משתמש changeStorage=Change storage changesNotSaved=השינויים לא נשמרו classDiagram=Class Diagram userJoined=כיף {1} הצטרף userLeft=כיף {1} עזב chatWindowTitle=צ'אט chooseAnOption=בחר אפשרות chromeApp=אפליקציית כרום collaborativeEditingNotice=Important Notice for Collaborative Editing compare=Compare compressed=דחוס commitMessage=הודעת commit configLinkWarn=This link configures draw.io. Only click OK if you trust whoever gave you it! configLinkConfirm=Click OK to configure and restart draw.io. container=Container csv=CSV dark=Dark diagramLanguage=שפת הדיאגרמה diagramType=Diagram type diagramXmlDesc=XML File diagramHtmlDesc=HTML File diagramPngDesc=Editable Bitmap Image diagramSvgDesc=Editable Vector Image didYouMeanToExportToPdf=Did you mean to export to PDF? disabled=Disabled draftFound=נמצאה טיוטה עבור '{1}'. טען אותה אל העורך או מחק אותה כדי להמשיך. draftRevisionMismatch=There is a different version of this diagram on a shared draft of this page. Please edit the diagram from the draft to ensure you are working with the latest version. selectDraft=Select a draft to continue editing: dragAndDropNotSupported=גרירה אינה נתמכת עבור תמונות. תרצה לייבא תמונה במקום? dropboxCharsNotAllowed=התווים הבאים אינם מותרים לשימוש: / \ : ? * " | check=בדוק checksum=Checksum circle=עיגול cisco=Cisco classic=קלאסי clearDefaultStyle=נקה סגנון ברירת ה ``` -------------------------------- ### Diagram Duplication and Editing Restrictions Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_hr.txt Contains messages related to diagram duplication, including warnings about diagrams used in multiple places, restrictions on editing linked diagrams, and errors encountered during the duplication process. It also covers limitations on editing diagrams within templates or when drafts are present. ```English diagDupl=Duplicate Diagram Detected ``` ```English diagDuplMsg=This diagram is used in multiple places, which can result in unexpected results when edited. We've created an independent copy. Please open the editor again. ``` ```English diagDuplNoEditMsg=This diagram is used in multiple places. Please edit it within its own page. ``` ```English dupDisabledPgLyrSlct=Diagram duplication is disabled when page and layers are selected ``` ```English cantDupPickDiffName=Could not duplicate diagram. Please choose a different name. ``` ```English ownPgAccessDupErr=Owning page access restriction: cannot duplicate diagram. ``` ```English cantDupTryLater=Could not duplicate diagram. Please try again later. ``` ```English cantEditLnkd=Cannot edit linked diagram ``` ```English diagEditOwnPgOnlyOpen=Diagram can only be edited from the page that owns it. Would you like to open the owning page for edit? ``` ```English diagInTemps=draw.io diagrams in templates ``` ```English diagInTempsCantEdit=Diagrams in page templates cannot be edited. They can only be edited on pages and blog posts. ``` ```English confDirectEditDraftLost=This Confluence page has unpublished changes. Editing the diagram from page view may cause data loss. Please edit the Confluence page first and then edit the diagram. ``` ```English confEditOnlyInPageEditor=Can only be edited within Confluence page editor ``` ```English otherUsersEditing=Other user(s) are editing this diagram ``` -------------------------------- ### Custom Templates Management Source: https://github.com/jgraph/drawio/blob/dev/src/main/webapp/resources/dia_bn.txt Explains how custom templates are managed within draw.io, specifically that they are draw.io diagrams saved as child pages of a designated templates page. ```APIDOC CustomTemplates: Definition: draw.io diagrams saved in children pages of a designated "Templates page". Details: Refer to the "Templates page" for more information. ```