Welcome Guest, Not a member yet? Register   Sign In
Authoring guide
#9

In addition to reading the manual, I would recommend setting up an author account on Leanpub and checking it out before you get too far along. The books I am working on with Lonnie and Kenji are written in Markdown, with a mix of inline code snippets and imports from PHP files. For me, it's only slightly different from working on Bonfire's documentation or writing a comment on GitHub, and being able to do something like this to add a code snippet is pretty sweet:

Code:
{line-numbers=on,crop-start-line=10,crop-end-line=25}
<<[Title Of Code Snippet](code/MY_Controller.php)

Very few people would want to see code as it's displayed in my editor, and it isn't optimal for print, either. Additionally, an image of text doesn't work well when you need to make it available in multiple paper sizes or on mobile devices (it would also be difficult to make an image accessible to users with vision problems).
Reply


Messages In This Thread
Authoring guide - by ignitedcms - 10-24-2015, 04:13 PM
RE: Authoring guide - by ignitedcms - 10-28-2015, 11:24 AM
RE: Authoring guide - by Narf - 10-28-2015, 11:47 AM
RE: Authoring guide - by ignitedcms - 10-28-2015, 11:51 AM
RE: Authoring guide - by Narf - 10-28-2015, 12:02 PM
RE: Authoring guide - by ignitedcms - 10-28-2015, 12:10 PM
RE: Authoring guide - by mwhitney - 10-28-2015, 12:37 PM
RE: Authoring guide - by ignitedcms - 10-28-2015, 01:00 PM
RE: Authoring guide - by mwhitney - 10-28-2015, 02:12 PM
RE: Authoring guide - by ignitedcms - 10-28-2015, 03:11 PM
RE: Authoring guide - by kenjis - 10-29-2015, 12:21 AM



Theme © iAndrew 2016 - Forum software by © MyBB