Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • Aug 21 15:12
    Octogonapus starred mosra/m.css
  • Aug 21 11:51

    mosra on master

    documentation: add an actual di… (compare)

  • Aug 21 11:42

    mosra on next

    documentation: add an actual di… (compare)

  • Aug 18 01:57
    dengbangjie starred mosra/m.css
  • Aug 10 18:39
    mosra opened #109
  • Aug 08 21:30
    pbtoast starred mosra/m.css
  • Aug 06 13:48
    nathanrosspowell starred mosra/m.css
  • Aug 03 10:55

    mosra on master

    css: make .m-diary left padding… (compare)

  • Aug 01 16:50
    lukts30 starred mosra/m.css
  • Jul 23 01:42
  • Jul 23 01:42
    ourobouros starred mosra/m.css
  • Jul 18 18:58

    mosra on master

    documentation/python: um, why d… doc: remove outdated / redundan… documentation/python: support e… and 2 more (compare)

  • Jul 18 18:45

    mosra on next

    doc: Python doc generator *can*… Add file encoding to .editorcon… documentation/python: um, why d… and 3 more (compare)

  • Jul 18 16:19

    mosra on master

    documentation: move search-rela… documentation/doxygen: update J… documentation: first step to ma… and 28 more (compare)

  • Jul 18 15:57

    mosra on next

    documentation/python: wtf, why … documentation: make the general… documentation: doc++ and 13 more (compare)

  • Jul 18 11:38
    Travis mosra/m.css (next) fixed (488)
  • Jul 18 11:34

    mosra on next

    documentation: encode format ve… documentation: ensure the extra… documentation: remove dead code. and 12 more (compare)

  • Jul 18 11:02
    Travis mosra/m.css (next) broken (487)
  • Jul 18 10:59

    mosra on next

    documentation: add sanity check… documentation: encode format ve… documentation: ensure the extra… and 11 more (compare)

  • Jul 16 11:50
    eliasku starred mosra/m.css
Nathan Ross Powell
@nathanrosspowell
Right now I'm digging about in the doxygen.py class to try and add back support for plantuml.
Vladimír Vondruš
@mosra
hmmm not sure about that
with everything else (math, dot graphs, ...) the xml output had just the plain source
so basically i had to call latex / dot / ... myself to get something that's actually renderable on a webpage
Nathan Ross Powell
@nathanrosspowell
Yes, this is looking the same. There is a <plantuml> node in a <para> in the XML. It's the plain text plant uml. It gets changed to an img link with a stripped down name like inline_umlgraph_1.png.
Using m.css I can see the latex file for the image is there, I'm just not sure how to generate that png or how to find the actual file I need :) Maybe I just go around all of it.
I did actually encounter a crash here: https://github.com/mosra/m.css/blob/master/documentation/doxygen.py#L1497
The entityis used without ever being set if the try fails. Simple fix. I will submit a merge request of just that if I can't support plantuml nicely
Vladimír Vondruš
@mosra
thanks in advance for the PR! :+1: if you could adapt the test for this as well, that would be great
here's the test input: https://github.com/mosra/m.css/blob/master/documentation/test_doxygen/contents_typography/input.dox ... either the CI will tell you what needs to be updated or you can run python -m unittest test_doxygen.test_contents.Typography in the documentation/ dir
Nathan Ross Powell
@nathanrosspowell
Cool! I will give that a shot :)
Vladimír Vondruš
@mosra

I'm just not sure how to generate that png or how to find the actual file I need :)

to keep the spirit of m.css, a SVG that goes directly into the page (inlined) and follows the theme (colors using the CSS classes) would be the best, but maybe that's too much to ask :D

also I never did any UML or used plantuml so i have no idea if any of that applies here
Nathan Ross Powell
@nathanrosspowell
My progs like it for class and sequence diagrams, you don't need to drag around lines in a GUI.
We have native support for it in other software, so never played with the export settings, but it looks like there is a SVG output option :)
Vladimír Vondruš
@mosra
ok, great :) the absolute minimum you need to do in order to place it inside the HTML markup is stripping away the <?xml?> declaration at the top (browsers don't like it very much) and convert the width/height attributes to CSS properties ... styling is a secondary problem
code that already does this is in plugins/dot2svg.py or plugins/latex2svgextra.py, the first is probably simpler ... doxygen.py then IIRC imports those and calls the utility function / regexps from there
those are outside because the code is shared also for the Pelican theme
but in case of plantuml it can be just doxygen-specific at first, so no need to overthink with those, add the SVG patching stuff straight to doxygen.py :)
Nathan Ross Powell
@nathanrosspowell
Cool. I'm going to give it a go in my spare time
João Carlos Becker
@jcbecker
Is m.css well suited for write content in markdown?
Vladimír Vondruš
@mosra
@jcbecker you mean the Doxygen part of it or the Pelican theme? For Doxygen yes, although it comes with severe limitations, for Pelican you'll have a much wider range of possibilities using reST. Markdown can't express many essential things (annotating elements with CSS classes, nested blocks, custom elements, complex tables...) at all, so I didn't even bother with it when creating the theme.
João Carlos Becker
@jcbecker
got it, I referred to writing content for pelican
Thanks for the reply and congrats for the great work at m.css and magnum
:)
@Octogonapus
Has anyone seen an error like this before? I can't figure out what part of my code is causing it. https://pastebin.com/5zBqqkK4
Vladimír Vondruš
@mosra
@Octogonapus are there any warnings/errors from doxygen before? this usually happens when there's a duplicated @section marker
Vladimír Vondruš
@mosra
@Octogonapus i just pushed mosra/m.css@ef63c51 that gives a better diagnostic in this case, can you re-run and tell me what it prints?
:)
@Octogonapus
@mosra Yes, later today
:)
@Octogonapus
@mosra Here is the latest output, I included from the failure up to the last warning. https://pastebin.com/9cBi2qPm
Vladimír Vondruš
@mosra
wait, this seems to be parsing m.css's own test files, why?
how do you invoke the script?
:)
@Octogonapus
I am in directory /home/salmon/Documents/OkapiLib/m.css/documentation and I run ./doxygen.py ../../Doxyfile-mcss --debug
The docs seemed to suggest I need to cd into m.css/documentation
Should I add exclusions for m.css into my Doxygen file?
Vladimír Vondruš
@mosra
you don't need to cd there, no ... but this seems to be recursing into it so an exclusion is necessary, yes
:)
@Octogonapus
Makes sense, my Doxyfile is set to be recursive
Vladimír Vondruš
@mosra
unfortunately there's no easy way to prevent this from happening from within the script itself
alternatively if you would have src/ in INPUT (instead of the root dir), then it wouldn't recurse into m.css
:)
@Octogonapus
Hmm, I added "m.css" to EXCLUDE but I still get the same error.
I have it set to recursive because I have a lot of directories it needs to go into.
Vladimír Vondruš
@mosra
there are probably stale xml files from the previous run, can you delete the output directory first?
:)
@Octogonapus
No error that time
Vladimír Vondruš
@mosra
ok great :)
:)
@Octogonapus
Something is weird with the Classes page, though, not everything is showing up. And there is no contents on the Files page. Do I just need to configure it?
Vladimír Vondruš
@mosra
classes, namespaces and files have to be annotated: https://mcss.mosra.cz/documentation/doxygen/#generated-output-is-mostly-empty
:)
@Octogonapus
I see.. I was hoping to get away without it ;)
Oh well
Vladimír Vondruš
@mosra
alternatively you can configure it to include everything even if it's undocumented, but even with that doxygen itself will sometimes behave strangely or won't allow you to link to undocumented functions, so the first is preferred
enabling this option is good when porting a project to m.css for the first time, and then disable it again once everything is sufficiently documented
:)
@Octogonapus
Sounds like a better option for now, then. Fixing the docs for everything will take a long time
That works great, thanks for all the help
Vladimír Vondruš
@mosra
you're welcome!