After updating the AnQiCMS version, will the configuration and integration of Markdown, formulas, and flowcharts be retained or need to be reconfigured?

As an experienced CMS website operation personnel of AnQi, I fully understand your concern for the continuity of content display and configuration during system upgrades.Markdown, mathematical formulas, and flowcharts are an important part of modern content creation. Whether their configuration can seamlessly connect after version updates is a concern for many operators.Next, I will elaborate on this consideration based on my in-depth understanding of AnQiCMS.

AnQiCMS updated Markdown, formula, and flowchart configuration continuity analysis

In the daily operation of AnQi CMS, we deeply understand the importance of the choice of content editor and its extended functions.AnQiCMS introduces a Markdown editor, and supports integration of mathematical formulas and flowcharts through third-party plugins, greatly enriching the expression of content.However, when it comes to system version updates, whether these configurations will be retained requires us to analyze from several different levels in detail.

The core mechanism of AnQi CMS for processing Markdown content lies in its backend content editor.According to the existing document description, the new Anqi CMS has added a Markdown editor, and the 'Content' field will automatically convert the content to html when the Markdown editor is enabled.This indicates that the conversion of Markdown text to HTML is a process controlled by the backend, which depends on the enable status of the Markdown editor on the "Content Settings" page in the "Global Settings" of the AnQiCMS backend.

And the display mechanism of mathematical formulas and flowcharts is different, the document clearly states that they all need to be supported by third-party plugins to display normally.This means that in addition to the backend parsing of Markdown, your website's frontend also needs to integrate specific JavaScript libraries (such as MathJax for formulas, Mermaid for flowcharts) and corresponding CSS styles to correctly render these advanced contents.These frontend integrations are usually in the template files of the website (such asbase.htmlManually add CDN links or local scripts in it.

An analysis of the retention of configurations after version updates can be made based on the above mechanisms:

first, About the enable status and backend parsing capabilities of the Markdown editor.The "Enable Markdown Editor" setting of AnqiCMS is stored in the system configuration and is usually retained in the database with the update of the core program.Unless the update log explicitly states that this type of user configuration will be reset, the setting is usually not changed.This means that if your content is stored in Markdown format and the Markdown editor is enabled before the update, the content will still be correctly parsed into HTML after the update.

secondly,About the frontend rendering configuration of mathematical formulas and flowcharts.This is the part you need to pay special attention to. Since these rendering features depend on the third-party library references you manually add to the template file, whether the configuration is retained or not directly depends on the template processing method during the update process:

If you choose to update the AnQiCMS core programKeep the custom template you are currently using, do not replace or updateall thebase.htmlThe MathJax, Mermaid scripts, and Markdown style CDN links manually added to other related template files will continue to exist.In this case, as long as the backend Markdown editor remains enabled and the content itself is in the correct Markdown format (including formula and flowchart syntax), the display of these advanced contents on the front end will not be affected, and the configuration does not need to be re-established.

However, if you update the AnQiCMS core program at the same time,choose to update, replace, or switch to a completely new templateIt is likely that the new template file does not include the integration code for the mathematical formulas and flowcharts that you manually added before.Because the default template provided by the official or the new third-party template usually only includes basic functions, it will not pre-integrate all possible third-party libraries.In this case, you will need to re-followhelp-markdown.mdThe guidance in the document, manually adding the relevant code for MathJax and Mermaid to the new template againbase.htmlIn the file, make sure the Markdown editor is enabled in the background "Global Settings".

Suggested steps and procedures:

To ensure that the updated content displays correctly, regardless of the update strategy you choose, I suggest the following operations after updating the AnQiCMS version:

1. Check background settings:Log in to the AnQi CMS backend, go to "Global Settings" -> "Content Settings", and confirm that the "Enable Markdown Editor" option is still enabled.
2. Backup the template file: Before performing any system updates or template replacements, please ensure that you backup your current template folder. This includespublic/static/static resources in the directory./templateAll template files under the directory, especially those you may have modifiedbase.htmlor other core templates.
3. Verify front-end rendering:After updating, immediately access the page containing mathematical formulas and flowcharts to check if its display is normal on the front end.
4. Re-integrate (if necessary):If you find that the formula or flowchart is not rendered correctly, refer tohelp-markdown.mdthe document, check yourbase.htmlOr the current basic template file, make sure that the CDN references to MathJax and Mermaid have been added correctly.

In summary, the AnqiCMS's ability to parse Markdown content on the backend will remain stable after version updates, but the frontend rendering of mathematical formulas and flowcharts is highly dependent on manual integration in the template files.Manage your template files carefully during the update process, and perform the necessary checks and reconfiguration after the update to ensure a smooth transition of content.

Frequently Asked Questions (FAQ)

1. I upgraded AnQiCMS, but the original mathematical formulas and flowcharts on the website cannot be displayed. What is the reason?This usually happens because you updated or replaced the template files of the website during the upgrade process, which caused the JavaScript code and CSS styles used to render mathematical formulas (such as MathJax) and flowcharts (such as Mermaid) in the template to be lost. You need to followhelp-markdown.mdDocument guidance, re-add the references to these third-party libraries to the template file you are currently using (for examplebase.htmlPlease check if the Markdown editor is enabled in the "Global Settings" -> "Content Settings" of the Anqi CMS backend.

2. Even if I have enabled the Markdown editor, the Markdown syntax in the content is still not converted to HTML, what is the problem?Firstly, make sure that your content is indeed written in Markdown syntax.If confirmed without any errors, and the Markdown editor is enabled but the content has not been converted, it may be due to cache issues.Please try to clear the browser cache and the system cache of the CMS backend.If the problem persists, it may be necessary to checktag-/anqiapi-archive/142.htmlinContentThe field's invocation method, ensure it is not explicitly set torender=falseor check if there is other custom logic interfering with the default Markdown rendering.

3. Will my old content be automatically converted to Markdown if I upgrade from an old version, and I haven't used the Markdown editor before, and now the new version has it?I won't. After AnQiCMS adds the Markdown editor, you can choose to use Markdown format when creating or editing content in the background.But your existing content, if it was initially entered in plain text or rich text (HTML) format, the system will not automatically convert it to Markdown format.You need to manually edit this old content and convert it to Markdown syntax in order to use the Markdown editor for management and rendering.