Skip to content
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

Figure legends #3

Open
rmzelle opened this issue Jun 26, 2013 · 2 comments
Open

Figure legends #3

rmzelle opened this issue Jun 26, 2013 · 2 comments

Comments

@rmzelle
Copy link
Contributor

rmzelle commented Jun 26, 2013

pandoc supports "Pictures with captions" (see http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html ), but that won't work for GitHub Pages.

Currently I have been using
![Adding a tag in the Tags tab of an item.](screenshots/OSX-ZS-4.0.8-tag-tab.png)
but the text in this link ends up in the "alt" attribute of <img/>, which is only shown if the image can't be loaded. Somewhat better would be if we could populate the "title" attribute, which would show up as a tooltip, but I haven't found a way.

I guess we could either use straight HTML in our markdown and use the "title" attribute, or just add a caption-like description following the image, like:

![image](screenshots/OSX-ZS-4.0.8-tag-tab.png)  
**Adding a tag in the Tags tab of an item.**

(note the two spaces after the image to force a line break)

@adam3smith
Copy link
Contributor

I don't like hard-coding the caption.
I'd actually be OK not having captions in the HTML and just having them in the PDF and ebook versions, which we'll generate with Pandoc anyway.
If you're really attached to captions in the HTML, my preferred version would be to run Pandoc locally after all, but we'd only have to do this towards the end.

@rmzelle
Copy link
Contributor Author

rmzelle commented Jun 26, 2013

Ok. I'll just keep my current format

![Adding a tag in the Tags tab of an item.](screenshots/OSX-ZS-4.0.8-tag-tab.png)

and be a bit more explicit in the text about describing what's in the various screenshots.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants