benetech / mmlc-api

MathML Cloud API
Other
28 stars 28 forks source link

twitter etc #144

Open pkra opened 9 years ago

pkra commented 9 years ago

I'm not sure this is the right place but it might be nice to provide metadata on equation 'landing' pages like https://mathmlcloud.org/#/equation/558bcc198dee8d7c38635a03 so that social media can pick them out as preview. E.g., by using twitter cards, a tweet could "attach" equations by just including the link -- and twitter will pick up the image in its preview.

sueannma commented 9 years ago

this is a great suggestion. have you already started seeing demand for this, as in people are interested in generating links from MathML Cloud and adding them to their twitter cards/tweets?

pkra commented 9 years ago

We see things like "why doesn't twitter use MathJax", "how can I write math on twitter" regularly (though not super often, maybe once per month). Similarly for facebook / open-graph

Since facebook and twitter will only generate a preview from one link (not multiple ones), I think this is primarily useful on twitter (140chars per equation sounds like a decent ratio).

sueannma commented 9 years ago

I’m not that familiar with how metadata is picked up by social media such as Twitter and Facebook, so could use your help explaining this a bit further...

Is the proposed solution something along the lines of a user goes to MathML Cloud to generate a math equation, then takes the PNG output and adds that to a twitter card along with a link to the source MathML Cloud URI? Or is there a more direct way to generate a "preview”? Also, what are the expected metadata tags that would be used to attach the link - is the suggestion to use the Alt for an image (assuming it's <140 characters)? If there's standard documentation from social media sites on how such metadata should be best tagged, please let us know!

jbrugge commented 9 years ago

Sounds like you are suggesting page-level metadata along these lines: https://dev.twitter.com/cards/markup

pkra commented 9 years ago

I’m not that familiar with how metadata is picked up by social media such as Twitter and Facebook,

The getting started section of the twitter docs mentioned by @jbrugge has a simple example at the bottom which should give a good idea.

Is the proposed solution something along the lines of a user goes to MathML Cloud to generate a math equation, then takes the PNG output and adds that to a twitter card along with a link to the source MathML Cloud URI?

My idea was that a link should be enough thanks to cards. E.g. using the summary card with an image and the speech text in the description.

Also, what are the expected metadata tags that would be used to attach the link - is the suggestion to use the Alt for an image (assuming it's <140 characters)?

Alt-text doesn't seem to work (cf Steve Faulkner's post)

If there's standard documentation from social media sites on how such metadata should be best tagged, please let us know!

Above for twitter, here for facebook https://developers.facebook.com/docs/sharing/best-practices

sueannma commented 9 years ago

Appreciate the details and clarifications. We're a little stretched with development resources, but have added this to the list of feature enhancements and will let you know when things progress. In the meantime, please keep us posted on any changes in urgency regarding this feature. Thanks!