metanorma / stepmod-utils

Tools for working on the STEPmod repository.
1 stars 0 forks source link

Annotated EXPRESS schema content: text formatting and figure naming issues #262

Open manuelfuenmayor opened 4 months ago

manuelfuenmayor commented 4 months ago

From https://github.com/metanorma/iso-10303/issues/248

All schema files present these markup issues:

  1. Partial bold text is marked up with single asterisks, which generates malformed rendering: issue3-generated

  2. Figure xref links don't match with their corresponding anchors.

    (*"geometry_schema.axis2_placement_3d.p.__figure"
    [[figure-geometry_schema-Geomfig3]]
    .Axis2_placement_3d
    ====
    image::Geomfig3.gif[]
    ====
    *)
    
    (*"geometry_schema.axis2_placement_3d.p.__note"
    See <<figure_Geomfig3>> for interpretation of attributes.
    *)
  3. Italic bold texts are marked up incorrectly:

    where _*V*_ and _*E*_ are the numbers of unique vertices and edges in the graph.

    It should be *_V_* and *_E_*.