1/8/2024 0 Comments Kable rmarkdownThe social sciences are the warzone, where the majority of disciplines and individuals probably use the office model, to the eternal consternation and annoyance of those who utilize the engineering model. The engineering model tends to be more prevalent in the hard sciences and STEM fields, while the office model is more common in the humanities. In this model, the actual substantive content of the text and the visual presentation of that text are separated. This plain-text file can then be processed by another application to produce the final viewable output in a variety of formats (e.g. HTML, PDF, docx). In the engineering model, manuscripts are written in a plain-text file with some kind of logical markup applied. Very often, because of some unavoidable facts about the world, the final output of this kind of solution is also a. pdf using some kind of typesetting or conversion tool. Final outputs are assembled from the plain text and turned to. Citation and reference management will likely also be done in plain text, as with a BibTeX. Data analysis is managed in code that produces outputs in (ideally) a known and reproducible manner. Changes are tracked outside of files, again using a version control system. The most “real” thing in your project will either be those files or, more likely, the version control repository that stores the project. In the Engineering model, meanwhile, plain text files are at the center of your work. On the other hand, in the “engineering”" model the approach is very different. The actual substantive content of the text and the visual presentation of that text are inseparable. In the office model, manuscripts are in typically written in an application like Microsoft Word that is WYSIWYG (What-You-See-Is-What-You-Get). docx file, cleaned up and with the track changes feature turned off. The final output is exported from it, perhaps to PDF or to HTML, but maybe most often the final output just is the. The master document may be passed around from person to person to be edited and updated. The outputs of data analyses-tables, figures-get cut and pasted in as well, or are kept alongside them. Citation and reference managers plug into those files. Changes to your work are tracked inside that file or files. A Word file or set of files is the most “real” thing in your project. Office solutions tend towards a cluster of tools where something like Microsoft Word is at the center of your work. There are basically two models for producing manuscripts. I am drawing here on Kieran Healy’s Plain Person’s Guide to Plain Text Science paper, which I would highly encoruage you to read. In order to understand the idea of R Markdown files, its important to have some understanding of how scientific manuscripts are produced.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |