|
|
Line 1: |
Line 1: |
| {{DISPLAYTITLE:Webservice: PDF-Export}}
| | Mathoid is a nodjs service which takes various forms of math input and converts it to MathML + SVG or PNG output. |
| __TOC__
| |
| Make sure that the [[Setup:Installation Guide/System Preparation/Windows/Apache Tomcat|Apache Tomcat server]] is completely installed and configured on the BlueSpice server before setting up PDF-Export.
| |
|
| |
|
| ==Moving the BShtml2PDF Application==
| | {{Messagebox|boxtype=important|icon=|Note text=Beginning with BlueSpice 4.x, Mathoid is no longer distributed and has to installed separately. |
| {{Messagebox|boxtype=important|icon=|Note text=Starting in BlueSpice 4.x, BShtml2 is no longer in the distribution and has to be downloaded and installed separately. | |
| <br /> | | <br /> |
| Download: https://buildservice.bluespice.com/webservices/4.2.x/BShtml2PDF.war|bgcolor=}} | | Download: https://buildservice.bluespice.com/webservices/4.2.x/mathoid.tar.gz|bgcolor=}} |
| Download the file "BShtml2PDF.war" and copy it to <code><tomcat-webapps></code>
| |
|
| |
|
| The default paths are as follows:
| | If mathematical formulas are not rendered in your wiki, please check that <code>extensions/Math/webservices/mathoid.tar.gz</code> is deployed in the correct folder: |
| | | *Linux: <code>/opt/mathoid</code> |
| *C:\Program Files\Apache Software Foundation\Tomcat 10.0\webapps '''(Apache Tomcat on Windows)'''
| | *Windows: <code>C:\BlueSpice\bin\mathoid</code> |
| */var/lib/jetty9/webapps '''(Jetty on Debian)'''
| |
| | |
| Or run the command <code>sudo mv /var/www/bluespice/w/extensions/BlueSpiceUEModulePDF/webservices/BShtml2PDF.war /var/lib/jetty9/webapps</code> in the terminal. '''(Linux)'''
| |
| | |
| The application usually starts automatically without the need for rebooting the application server.
| |
| | |
| ==Checking the functionality==
| |
| The correct functionality of the BShtml2PDF service can be checked as follows:
| |
| | |
| On Windows, open Internet Explorer using the URL <nowiki>http://localhost:8080/BShtml2PDF</nowiki>. With correct functionality, you should see the following website:
| |
| [[File:Setup:Tomcat_Check_03.png|center|400px|Tomcat Check 03]]
| |
| | |
| ==Enable PDF Export in BlueSpice==
| |
| Go to the directory <code><installpath-bluespice>/settings.d</code>. Open the file '''020-BlueSpiceUEModulePDF.php''' in a text editor.
| |
| | |
| Or open the 020-BlueSpiceUEModulePDF.php in the terminal using the command <code>sudo nano /var/www/bluespice/w/settings.d/020-BlueSpiceUEModulePDF.php</code>. '''(Linux)'''
| |
| | |
| In the second line is the code to activate the extension:
| |
| | |
| return; // Disabled. Needs Tomcat | |
| | |
| You can either add a comment character (#) to the beginning of this line or delete the line completely, save the file and exit it.
| |
| | |
| {{Messagebox|boxtype=note|Note text=Give the user "Everyone" full access to the Temp folder under C:\Widows.}}
| |
| | |
| ==Installing BlueSpice 3 with installer==
| |
| | |
| #Open <code>localhost/w</code> in your Browser and follow the [[:en:Setup:Installation_Guide/With_Installer|instructions]].
| |
| #For BlueSpice WikiFarm, move the .htaccess and web.config files to C:\bluespice\var
| |
| | |
| Open a command line and change into the folder <code><installpath-bluespice></code>. Execute the following command:
| |
| | |
| php maintenance/update.php ''(Linux)''
| |
| php maintenance\update.php ''(Windows))''
| |
| {{Messagebox|boxtype=note|Note text=In Windows, make sure that the environment variables are set correctly to access the "php" command.}}
| |
| {{Messagebox|boxtype=note|Note text=Note that you must update the [[Setup:Installation Guide/Security Settings/File System Permissions#Assignment_of_Permissions_with_Linux|file system permissions]] after running update.php.}}
| |
| | |
| When the script is finished with the "Done" message, you have successfully isntalled the web service .
| |
| | |
| [[File:Setup:Setup_bluespice_maintenance_update.jpg|center|400x556px]]
| |
| | |
| ==Troubleshooting==
| |
| If there is a problem with the PDF export in BlueSpice, first check the [[Setup:Installation Guide/Security Settings/File System Permissions|file system permissions]].
| |
| ==Download Web services==
| |
| If the required war-file is missing in your installation package, you can download it here: [https://buildservice.bluespice.com/webservices3.tar.gz Webservices].
| |
| | |
| | |
| [[en:{{FULLPAGENAME}}]]
| |
| [[de:Setup:Installationsanleitung/Webservices/PDF-Export]]
| |