Coder Social home page Coder Social logo

monicaycli / my-writing-workflow Goto Github PK

View Code? Open in Web Editor NEW
38.0 2.0 7.0 3.57 MB

Tutorial for converting markdown files in to APA-formatted docs, based on my workflow.

TeX 100.00%
markdown rmarkdown pandoc apa publication academic writing workflow pdf docx

my-writing-workflow's Introduction

My Writing Workflow

markdown, pandoc, and more!

  1. I use Mendeley to organize and annotate PDF files of academic articles.
  2. Mendeley can automatically generate .bib files that contain citation info of all or part of your Mendeley library.
  3. .csl files specify what citation style (e.g., APA) the references will be formatted in. It can be extracted from Mendeley or easily obtained from the internet.
  4. Scrivener is a writing program I use for organizing my writing projects. It's good for making outline, moving things around, focusing on selective parts of a manuscript, taking notes, gathering research materials, exporting to various file formats etc.
    • Note: Scrivener is a paid software. There is an open-source alternative that I heard of, called Manuskript. I have not personally tried it, but it seems cool.
  5. I usually write in Scrivener and export the text as .md, so that version control can be done easily with git and github.
  6. .md text can be converted to APA-formatted documents via pandoc along with appropriate specifications, including a .bib file, a .csl file (in APA style), and a APA-formatted template (in my case, a .docx).
  7. Alternatively, to more easily include analyses and results in the manuscript, one can write in .Rmd to incorporate R code and outputs, and use papaja (an R package based on pandoc; recommended to use in R Studio) to convert the .Rmd into even more sophisticated version of APA documents then the previously mentioned regular pandoc approach.

In this repository

  • You will find examples of converting markdown (.md) or Rmarkdown (.Rmd) files into APA-formatted, publication-ready documents (e.g., .docx, .pdf, .tex), using pandoc or papaja.

  • Specific instructions can be found in example_pandoc.md and example_papaja.Rmd

  • APA_template.docx is modified from the template provided by papaja

  • APA_ML.csl is modified from the apa.csl obtained from Zotero, such that in press articles can be correctly cited with Mendeley.

    • Enter in press in the Short title field in Mendeley, which is equivalent to the shorttitle variable in .bib files
    • Note: If references are not managed via Mendeley, the regular apa.csl can be used with the status variable specified as in press for a given entry in .bib files
  • See example.bib for ways to specify different types of manuscripts, including:

    • published journal articles
    • published books
    • published book chapters
    • in press manuscripts
    • manuscripts submitted for publication
    • unpublished manuscripts
    • master's theses or doctoral dissertations

Useful links

reference management

text editing

file conversion / formatting

version control

my-writing-workflow's People

Contributors

monicaycli avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.