View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0028038 | Open CASCADE | Website:Portal | public | 2016-11-02 11:57 | 2016-12-09 16:39 |
| Reporter | Assigned To | apn | |||
| Priority | high | Severity | minor | ||
| Status | closed | Resolution | fixed | ||
| Product Version | 7.0.0 | ||||
| Target Version | 7.1.0 | Fixed in Version | 7.1.0 | ||
| Summary | 0028038: Incorrect documentation generated for "user guides/BRep Format" | ||||
| Description | It was found that "BRep Format" document contains a lot of TEX formulas. For some strange reason images have not been generated. The example below demonstrates such situation. \( f_{1}\; f_{2}\; f_{3}\; f_{4}\; f_{5}\; f_{6}\; f_{7} \) <flag>s \( f_{i}\;(1\leq i \leq 7) \) | ||||
| Steps To Reproduce | Open https://dev.opencascade.org/doc/overview/html/occt_dev_guides__documentation.html and check that the formulae at the end of the document are rendered correctly | ||||
| Tags | No tags attached. | ||||
| Test case number | Not needed | ||||
|
|
Apparently the problem is that MathJax does not load properly. The problem exists only for documentation that is located on our servers, including docs for previous releases, e.g.: https://dev.opencascade.org/doc/overview/html/occt_dev_guides__documentation.html https://www.opencascade.com/doc/occt-6.7.0/overview/html/dev_guides__documentation.html (examples of formulae are put at the end of this document). There is no such problem in documentation local documentation included with official release (installer) or generated from code. I could not find any difference between HTML code of the documentation from server against local version (apart of URLs). Hence, the problem seems to be most likely in server settings / configuration. Please investigate this. As a first step, I suggest copying docs back from server to local station and checking if the problem appears. |
|
|
This is because out websites moved to HTTPS, while the documentation contains links to external HTTP resources (MathJax), that is insecure from the the point of view of browsers. It is always better to load external resources via HTTPS, if available. Thus could you please take care of this in next releases. Another way is to deliver documentation with local versions of external .js libraries. As for the old versions of documentation on the server, I will replace all links: http://cdn.mathjax.org/mathjax/latest/MathJax.js with the HTTPS ones: https://cdn.mathjax.org/mathjax/latest/MathJax.js |
|
|
Branch CR28038 has been created by aiv. SHA-1: 28e094c81b9152c5e2eab8ba79feeee2f70a2356 Detailed log of new commits: Author: aiv Date: Mon Nov 21 18:23:28 2016 +0300 0028038: Incorrect documentation generated for "user guides/BRep Format" References to external MathJax.js library were changed from HTTP to HTTPS alternative. |
|
|
Hi Andrey, I fixed references to MathJax.js on www.opencascade.com/doc/... I see no impact if references will be updated everywhere, so please find the corresponding changes in the CR28038 branch as well. As for updating documentation on dev.opencascade.org - it is yours. |
|
|
Reviewed and checked; please integrate (no testing is needed) |
|
|
Branch CR28038 has been deleted by kgv. SHA-1: 28e094c81b9152c5e2eab8ba79feeee2f70a2356 |
|
occt: master ce73cfd0 2016-11-21 15:23:28
Committer: apn Details Diff |
0028038: Incorrect documentation generated for "user guides/BRep Format" References to external MathJax.js library were changed from HTTP to HTTPS alternative. |
Affected Issues 0028038 |
|
| mod - adm/gendoc.tcl | Diff File | ||
| mod - dox/CMakeLists.txt | Diff File | ||
| Date Modified | Username | Field | Change |
|---|---|---|---|
| 2016-11-02 11:57 |
|
New Issue | |
| 2016-11-02 11:57 |
|
Assigned To | => ysn |
| 2016-11-19 17:16 |
|
Note Added: 0060571 | |
| 2016-11-19 17:16 |
|
Assigned To | ysn => aiv |
| 2016-11-19 17:16 |
|
Priority | normal => high |
| 2016-11-19 17:16 |
|
Status | new => assigned |
| 2016-11-19 17:16 |
|
Category | OCCT:Documentation => Website:Portal |
| 2016-11-21 12:21 |
|
Note Added: 0060608 | |
| 2016-11-21 18:26 | git | Note Added: 0060646 | |
| 2016-11-21 18:36 |
|
Assigned To | aiv => apn |
| 2016-11-21 18:37 |
|
Note Added: 0060647 | |
| 2016-11-22 11:16 |
|
Assigned To | apn => abv |
| 2016-11-22 11:16 |
|
Status | assigned => resolved |
| 2016-11-22 11:16 |
|
Steps to Reproduce Updated | |
| 2016-11-22 11:17 |
|
Note Added: 0060663 | |
| 2016-11-22 11:17 |
|
Assigned To | abv => bugmaster |
| 2016-11-22 11:17 |
|
Status | resolved => reviewed |
| 2016-11-22 12:25 |
|
Test case number | => Not needed |
| 2016-11-22 12:25 |
|
Status | reviewed => tested |
| 2016-11-24 15:52 | apn | Changeset attached | => occt master ce73cfd0 |
| 2016-11-24 15:52 | apn | Assigned To | bugmaster => apn |
| 2016-11-24 15:52 | apn | Status | tested => verified |
| 2016-11-24 15:52 | apn | Resolution | open => fixed |
| 2016-12-07 11:30 | git | Note Added: 0061262 | |
| 2016-12-09 16:30 |
|
Status | verified => closed |
| 2016-12-09 16:39 |
|
Fixed in Version | => 7.1.0 |
