papaja icon indicating copy to clipboard operation
papaja copied to clipboard

Would you mind developing papaja::apa6_html output format?

Open jooyoungseo opened this issue 5 years ago • 10 comments

I was wondering if you would mind developing a new output format that allows users to create their manuscript in HTML format like pagedown::thesis_paged()? It would be so much appreciated.

jooyoungseo avatar Jul 20 '19 11:07 jooyoungseo

Hi there, thanks for the suggestion. Were you thinking of something along the lines of what @CrumpLab describes here? Or are you looking specifically for a dissertation like look?

crsh avatar Jul 29 '19 12:07 crsh

Hello @crsh,

Using pkgdown looks great as well; however, I thought it would be more flexible if papaja can be rendered through pagedown that allows readers to view articles in HTML format and print them according to their needs. I did not mean any a dissertation-like look specifically.

jooyoungseo avatar Jul 30 '19 06:07 jooyoungseo

I think this CSS can be used for the HTML output. I also need to examine pagedown::thesis_paged() source code to understand its underlying principles.

jooyoungseo avatar Jul 30 '19 06:07 jooyoungseo

Great, thanks for clarifying. This would definitely be nice to have, but to be honest there are some more pressing issues that I need to tackle before I get around to this. In case anyone would like to jump on this, I'd be more than happy to consider a pull request.

crsh avatar Jul 30 '19 06:07 crsh

pagedown is pretty neat, but doesn't look like it is well supported by all browsers (doesn't work at all for me in Safari, but does on Chrome).

Adding an html option for papaja is interesting to me as well. I guess the question would be how to style the output. Not convinced it makes sense to style the output like a double-spaced pdf, but I guess I could see that as an option.

I'd probably me be more interested in a web-paper style, but I don't think there is a proper APA style for that. Maybe the easiest thing to do is something like how Springer renders the Psychonomic journals for the web, https://link.springer.com/article/10.3758/s13428-019-01282-6.

Maybe I'll tinker with this and see what happens

CrumpLab avatar Jul 30 '19 10:07 CrumpLab

@brentthorne, Would you mind giving your hand if you found this interesting to you?

jooyoungseo avatar Jul 31 '19 12:07 jooyoungseo

How do you feel about using distill?

crsh avatar Jul 31 '19 12:07 crsh

Wow, hadn't heard of distill, looks pretty great

CrumpLab avatar Jul 31 '19 12:07 CrumpLab

pagedown is pretty neat, but doesn't look like it is well supported by all browsers (doesn't work at all for me in Safari, but does on Chrome).

Adding an html option for papaja is interesting to me as well. I guess the question would be how to style the output. Not convinced it makes sense to style the output like a double-spaced pdf, but I guess I could see that as an option.

I'd probably me be more interested in a web-paper style, but I don't think there is a proper APA style for that. Maybe the easiest thing to do is something like how Springer renders the Psychonomic journals for the web, https://link.springer.com/article/10.3758/s13428-019-01282-6.

Maybe I'll tinker with this and see what happens

Hello @jooyoungseo and all,

As far as I'm aware pagedown is meant to be a LaTeX free method to producing PDF content. So if a template was to be made using it as a base then it would be a replacement for any LaTeX templates that exist. If you are looking to transition quickly between an article/ manuscript to an html website version of the content then pagedown makes that transition the most streamlined.

For example, if you have tables generated in an rmarkdown document formatted as LaTeX output but would like to have that table in an html website it would need to be changed and any LaTeX specific attributes would need to be altered, thus taking time. The benefit of pagedown is that you are guaranteed to have no compatibility or formatting time sinks when transitioning.

While browser compatibility is getting better for paged.js based documents, the main goal is to generate PDF documents which can be done with the pagedown::chrome_print("myDocument.rmd) in the R console.

I am currently working on pagedown alternatives to rticles templates with the peer review process in mind, aka line numbering and such so matching any other templates isn't a big deal.

I like the idea of possibly creating a web based style guide for APA since that is the direction most publications are headed anyways (html focused), distill seems like a cool option to base that off of or at least draw inspiration from.

brentthorne avatar Jul 31 '19 15:07 brentthorne

Did anyone manage to get a HTML from a papaja Rmd document? Any advice?

cjvanlissa avatar Sep 25 '20 08:09 cjvanlissa