-
Notifications
You must be signed in to change notification settings - Fork 13
Convert POD to Markdown #16
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
base: master
Are you sure you want to change the base?
Conversation
|
Gudday! Am just wondering what you think of the change to Markdown. Is this a good idea? I notice that you've merged my other patches, so there are now a few conflicts, I can fix those (if you want this PR to be merged) and force push an update to this branch so that you can merge the change to Markdown more easily. |
|
Hi Paul, if you have the time to merge my changes in what you've already done that would be great. I realised afterwards I should have waited until I'd merged yours, but too late :( I started to look through all the changes, but got waylaid with other things. I'm also in the middle of a couple of server moves, including the survey server, so it's been a bit hectic these last few weeks. Thanks for your work on this, it is very much appreciated, and please don't let my inertia be interpreted as a lack of enthusiasm for getting your changes committed :) |
Since this isn't built from POD anymore, we can simply use a normal Makefile and reduce the amount of code needed to be written in order to build pdf and epub documents.
deab561 to
da048a9
Compare
|
Hey, no worries :-) I know people have a lot on; just thought I'd ask and find out what the state of play was. I've rebased this branch onto the current master, so you should be good to go! |
|
Hi Barbie, have you had a chance to look through these changes? |
This PR converts the entire project from POD to Markdown. It changes the build step to use
pandocto convert the source files into PDF or EPUB as appropriate. This change allows potential contributors to edit the files directly on GitHub as well as reducing the barrier required to build the project and get output. There is possibly much more one could do and check, but this should get things going. There were some minor formatting changes necessary so that the POD fits into Markdown's model, hopefully these changes haven't changed the sense of the document significantly (it's probably not huge, but I thought you should at least know).