-
Notifications
You must be signed in to change notification settings - Fork 205
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Adds support for diagcess diagrams. #1944
base: master
Are you sure you want to change the base?
Conversation
I note that I can't choose reviewers. So here's an explicit ping: |
Very nice, @zorkow! We need some PreTeXt markup for this. Without HTML-centric I see an SVG image. Good, we already do that. In fact, we prefer that. We need a PDF for LaTeX. I'll try a manual conversion in Inkscape, that would be a good start. Annotations. Silly question - can they be embedded in the SVG somehow? A super-SVG? If not, what is In any event, I should be able to make quick progress with what is here, and we can streamline workflow as you and @davidaustinm get further along. Knowls: this is @davidfarmer's baby. Also, @bnmnetp has a lot of hard-won experience, especially with MathJax. Tuesday drop-in is at Noon Pacific if you want to pop in. PS: paper looks great! |
From Drop-In discussion:
|
@rbeezer you mentioned a way to add a link to the keyboard commands for the diagrams. Can you point me to the relevant code, so I can add them? |
That will be a one-off deal, and a first! So I'm not sure. Put commands here, and I may work on this in the AM. |
Found commands at CDN, will work on integrating. |
OK, getting close on doing this PreTeXt-style. Have "experimental" markup, and have hooked this into the usual processing.
Using <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/diagcess@1.1.1/dist/diagcess.js" defer=""></script>
<script type="text/javascript" defer="">
document.addEventListener("DOMContentLoaded", function() {
diagcess.Base.init();
});
</script> Console shows:
Beta here, Subsection 9.1: Holler if it goes missing, I am experimenting with |
Wonky ToC and Header is just the screenshot tool messing around. |
An Inkscape conversion of In the plus column, the |
We've had good luck embedding braille fonts in SVG, converting to PDF with
rsvg-convert, and embossing. Automating that process is the next thing on
my to-do list.
…On Fri, Mar 10, 2023 at 10:14 PM Rob Beezer ***@***.***> wrote:
An Inkscape conversion of network.svg to PDF lost all the labels. I
didn't try very hard. But maybe labels are non-standard in some way?
In the plus column, the rsvg-convert did just fine, which
@alexeikolesnikov <https://github.com/alexeikolesnikov> will find
comforting. ;-)
—
Reply to this email directly, view it on GitHub
<#1944 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/ABTLXTGYJLULFGGEURCQQX3W3PUZDANCNFSM6AAAAAAVRW2MCE>
.
You are receiving this because you were mentioned.Message ID:
***@***.***>
|
Here's a page with the instructions I can also send you the markdown for the page. |
Instructions for working with Accessible DiagramsYou can navigate through the diagrams with various keys. Reading the diagram Keys to Navigate {#keys-to-navigate}Initialisation
Righthanded Navigation
Lefthanded Navigation
Other Interaction ControlMagnification
Speech Output and Display
Sound Output
Navigating in a Diagram {#navigating-in-a-diagram}If you focusing a diagram you screen reader should announce ‘Navigatable
Getting started with your Screen Reader {#working-with-screen-readers}Here are some tips on what you might need to do to make it easier to work
|
Oops, I seem to be late to the party. I did not see the whole thread. I am sitting in the Santa Cruz with power and Internet outages... |
The latest released version of diagcess is We need to make a release from the latest version. But since this is part of our production environment we first need to test it thoroughly. I can spend some time on this Monday, when the hopefully the storm here is over. |
Thanks, @zorkow, for the updates. Thanks for working through this during the power cuts. And your battery charger dilemma.
Ok, good. I'll wait on that.
This is a bigger problem that we should stop trying to fix with Band-Aids. So it can wait, I'd say. |
Just to clarify: The |
This PR introduces the possibility of integrating interactive SVG diagrams into Pretext's HTML output. The basic idea is specify diagrams via their SVG image and XML annotation files
They are then translated into elements that can be picked up by the diagcess library of the form:
In addition, if images of this nature exist in a page (or knowl), the
diagcess.js
library is loaded and initialised, which replaces the above tag with interactive diagrams.Note, that at the moment it is expected that the
diagcess.js
file is in the same directory. This is due to the fact that I had to make some changes to the library, mainly to get the knowls workingfrom the npm CDN.
There are still some other issues we might need to discuss:
* We need to link to a page with the table for keyboard navigation
* Shall we always switch on voicing (currently yes) and sonification (currently no).
I might also have misunderstood some of the xsl code.
Anyway, for the time being, I've put a temporary version of our W4A paper here:
https://githubraw.com/zorkow/pretext/w4a2023/w4a2023/
In particular, interactive diagrams are on this page:
https://githubraw.com/zorkow/pretext/w4a2023/w4a2023/sec_intro.html