Terminology: EU language skills, and Master to Main (or ...)
[to folk subscribed to both the Python list and Python-Tutor: apologies for cross-posting] Regarding levels of skill or complexity in learning, the European Union has been working on "The Common European Framework of Reference for Languages: Learning, Teaching, Assessment". It also standardises terminology for spoken/national-language training courses. https://en.wikipedia.org/wiki/Common_European_Framework_of_Reference_for_Languages I'm not a fan of such abstract labelling of one's progress (or a tutorial's content) with codes or "reference levels" (A1, A2, B1, B2, C1, C2) but maybe it will become widely recognised... The web-page amuses (this small mind) noting non-PC stereotypes, that the ever-pragmatic Dutch have scaled language skills based upon how one wants to apply or use them; the Scandinavians go for numerical progression; which the Italians do similarly but with 'flair' (using words not digits). LanguageCert International have added the EU-codes to their practical terms: Preliminary, Access, Achiever, Communicator, Expert, Mastery. A group at the King Juan-Carlos University (Madrid, Spain) is collecting practitioners' opinions in a bid to categorise Python mastery according to the Framework. You may like to contribute by responding to their research surveys (one form takes five-minutes, the other fifteen): https://docs.google.com/forms/d/e/1FAIpQLSdlzWGpvZHLHXl6iEdHbLTB6QvYXknrD9-JKmzY7riYJkPmNw/viewform I like to label tutorials and conference-talks (and sometimes individual slides/sections) to indicate levels of complexity. However, have replaced abstract terms such as "Beginner" or "Junior", "Intermediate", and "Advanced" or "Senior" which all sound school-ish; with the three terms: "Apprentice", "Journeyman", and "Master" (see also https://leanpub.com/b/python-craftsman). Whilst, there have been folk unfamiliar with (UK) "Guild" terms, they generally respond readily to explanation and the professional context. NB I use the terms solely to indicate an expected audience, as distinct from assessing an individual's capability (or pay-rate)! There is a potential-problem in the rising sensitivity of the word "Master", eg the git CVS has replaced the idea of a Master-branch with "Main branch" (or user-chosen alternative name). Will referring to skilled professionals as 'masters (of their profession/craft)' transgress (international or at least US-instigated) 'Political Correctness'? What do you think a professionally-recognisable series of skill-levels for programmers? -- Regards, =dn -- https://mail.python.org/mailman/listinfo/python-list
Re: Recommendation for drawing graphs and creating tables, saving as PDF
If you don't want to have to do any layout, Graphviz, which you mentioned, is probably the best and there are/were Python libraries that will let you control it to automatically produce files. The whole point of graphviz is to do all the layout, however my only grip is it doesn't always make the best choices and then it is a bit of a burden to get it to do what you want. That was also years ago though so maybe the functionality has expanded. I used it then to create huge hierarchical graphs. Additionally Graphviz is more like a framework and there are in reality many backends to choose from. I started to look into this to see if there were backends that made more sense for my charts but the project lost steam and I never got back to it. That would be my recommendation and then like Martin said use Markdown plus pandoc. I have been using this system for years at work and it works really well. I will write up specifications and requirements in mark down so I can version control them in Git then I use Markdown to convert to Word and PDF to distribute to coworkers. If they make changes I just convert the files back to mark down and then I can use KDiff and other merge tools to review the changes and commit them if I want. Graphviz will export PNGs which you can embed easily in markdown. Graphviz can also work by typing up a simple viz file which is just text and then that file is compiled into the visualization. That text file can of course be version controlled which if you can't tell I am big on so this is another bonus for me. Chris Chris On Fri, Jun 11, 2021 at 10:35 PM Martin Di Paola wrote: > You could try https://plantuml.com and http://ditaa.sourceforge.net/. > > Plantuml may not sound as the right tool but it is quite flexible and > after a few tweak you can create a block diagram as you shown. > > And the good thing is that you *write* which elements and relations are > in your diagram and it is Plantuml which will draw it for you. > > On the other hand, in Ditaa you have to do the layout but contrary to > most of the GUI apps, Ditaa processes plaintext (ascii art if you want). > > For simple things, Ditaa is probably a good option too. > > Finally, I use https://pandoc.org/ to transform my markdowns into PDFs > for a textbook that I'm writing (and in the short term for my blog). > > None of those are "libraries" in the sense that you can load in Python, > however nothing should prevent you to call them from Python with > `subprocess`. > > By the way, I'm interesting too in to know other tools for making > diagrams. > > On Fri, Jun 11, 2021 at 08:52:20AM -0400, Neal Becker wrote: > >Jan Erik Moström wrote: > > > >> I'm doing something that I've never done before and need some advise for > >> suitable libraries. > >> > >> I want to > >> > >> a) create diagrams similar to this one > >> https://www.dropbox.com/s/kyh7rxbcogvecs1/graph.png?dl=0 (but with more > >> nodes) and save them as PDFs or some format that can easily be converted > >> to PDFs > >> > >> b) generate documents that contains text, lists, and tables with some > >> styling. Here my idea was to save the info as markdown and create PDFs > >> from those files, but if there is some other tools that gives me better > >> control over the tables I'm interested in knowing about them. > >> > >> I looked around around but could only find two types of libraries for a) > >> libraries for creating histograms, bar charts, etc, b) very basic > >> drawing tools that requires me to figure out the layout etc. I would > >> prefer a library that would allow me to state "connect A to B", "connect > >> C to B", "connect B to D", and the library would do the whole layout. > >> > >> The closest I've found it to use markdown and mermaid or graphviz but > >> ... PDFs (perhaps I should just forget about PDFs, then it should be > >> enough to send people to a web page) > >> > >> (and yes, I could obviously use LaTeX ...) > >> > >> = jem > > > >Like this? > >https://pypi.org/project/blockdiag/ > > > >-- > >https://mail.python.org/mailman/listinfo/python-list > -- > https://mail.python.org/mailman/listinfo/python-list > -- https://mail.python.org/mailman/listinfo/python-list
