{"id":22901251,"url":"https://github.com/mooerslab/writinglogtemplateinorg","last_synced_at":"2026-01-08T15:50:50.857Z","repository":{"id":60153077,"uuid":"534870274","full_name":"MooersLab/writingLogTemplateInOrg","owner":"MooersLab","description":"Template for writing.log in org-mode","archived":false,"fork":false,"pushed_at":"2025-03-27T12:41:12.000Z","size":2466,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T13:38:21.834Z","etag":null,"topics":["accountability","daily-log","hypothesis-centered-writing","hypothesis-driven-research","master-document","personal-productivity","planning-document","planning-tool","project-management","science-writing","scientific-writing","second-brain","self-monitoring","stress-management","time-management","voice-commands","workflows","writing-accountability","writing-productivity","writing-project-management"],"latest_commit_sha":null,"homepage":"https://github.com/MooersLab/writingLogTemplateInOrg","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MooersLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-10T02:38:21.000Z","updated_at":"2025-03-27T12:41:15.000Z","dependencies_parsed_at":"2024-01-22T01:35:28.680Z","dependency_job_id":"ee772901-762a-4951-9bdc-501b0b1ac03e","html_url":"https://github.com/MooersLab/writingLogTemplateInOrg","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FwritingLogTemplateInOrg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FwritingLogTemplateInOrg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FwritingLogTemplateInOrg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FwritingLogTemplateInOrg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MooersLab","download_url":"https://codeload.github.com/MooersLab/writingLogTemplateInOrg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246591782,"owners_count":20801984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accountability","daily-log","hypothesis-centered-writing","hypothesis-driven-research","master-document","personal-productivity","planning-document","planning-tool","project-management","science-writing","scientific-writing","second-brain","self-monitoring","stress-management","time-management","voice-commands","workflows","writing-accountability","writing-productivity","writing-project-management"],"created_at":"2024-12-14T01:32:30.333Z","updated_at":"2026-01-08T15:50:50.851Z","avatar_url":"https://github.com/MooersLab.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Version](https://img.shields.io/static/v1?label=writingLogTemplateOrg\u0026message=0.8.1\u0026color=brightcolor)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n\n# Writing project log template in org-mode\n\n## What is this? A space for metacognition and storing metadata about one writing project\n\nUse this template to store in one document outside of your writing project's main document (e.g., journal article, grant application, book chapter, book, lecture notes, seminar notes, talk notes, poster notes) the data and the thinking behind your writing project.\nThis document is meant to be specific to one project; create a separate document for additional projects.\nThis template addresses the problem of cluttering the writing project document with notes about decisions made and plans for the work.\nThis template provides a safe place for notes that tend to get deleted and lost upon manuscript submission.\n\nUse this writing log in parallel to the main writing project document to support these workflows:\n\n- project ideation and initiation (usually a 3-4 hour work session on day one)\n- Data inventory (update as needed)\n- Daily log to record decisions made, actions completed or attempted, and correspondence.\n- Periodic project assessment against timeline with milestones (once a week, month, or quarter -- whatever is appropriate)\n- Project completion and archiving (one to several days at manuscript submission or acceptance or a bit of both)\n\n## Why use this writing project log?\n\n- Eases restarting a project that has been interrupted.\n- Supports working on several projects concurrently.\n- Updates the fear of losing momentum.\n- Abates the fear of forgetting where you left off.\n- Supports the planning of related projects as you make progress on the current project. You will have a running start on the next writing project.\n\n## What this is not\n\n- This is not an extended annotated bibliography to store your thoughts about the literature you read. You can find elsewhere on the site repositories that support the assembly of classical annotated bibliographies. You will also find repositories for templates for modern bibliographies that support multi-paragraph entries illustrated with figures, tables, code listings, equations, and URLs to relevant websites, including videos.\n- This is not an accountability tool where you record your minutes spent on words written per day across one or more writing projects. You can find several different approaches to writing accountability on this website and the corresponding tools to support those approaches. You can choose one approach that you think you can use daily. Do not try to use more than one approach at a time. You will exhaust yourself and give up. If you schedule your writing activities and show up at the appointed time, the need for tracking your progress will be diminished when following the writing schedule becomes a deeply ingrained habit.\n\n\n## What is org-mode\n\n[Org-mode](https://orgmode.org/) is a rich variant of markdown (see [cheatsheet](https://devhints.io/org-mode)) that can read some LaTeX code directly.\nThe remaining LaTeX code can be used in a code block for LaTeX.\n\n\n## Features\n\n- 20 considerations for planning a manuscript.\n- A table of contents that is automatically generated and hyperlinked.\n- An automatically generated index that is hyperlinked.\n- Support for generating a references cited section from a BibTeX library.\n- A writing log section for recording notes about each day's accomplishments.\n- Plot of the word count by writing session to track your progress.\n- Use org-clock and clock tables to track and summarize your effort.\n- A GUIDANCE drawer that stores advice on how to use a section. The drawer is opened by placing the cursor on it and entering the tab.\n\n\n### Introduction\n\nThe writing log is a document that is external to the manuscript.\nIt stores the plans and progress made on one manuscript.\nIt is a tool for enhancing your focus and sustaining forward momentum on the writing project.\nIt is also a tool that eases re-engagement in an interrupted writing project.\nIt is like a master thinking document or a second brain for a writing project.\n\nInstructions for using the writing log are found in the annotations in the template.\nYou can delete these after they are no longer needed.\n\nVersion 0.8 of the writing log is divided into these sections: \n\n- Project initiation\n- Project data\n- Plans to support the project\n- Timely completion\n- Daily entries\n- Future additions and tangents\n- Guidelines, checklists, protocols, and helpful tips\n\nThe subsections of these sections are shown below.\n\n\n### Project initiation\n\n- Rationale\n- Audience\n- Target journals\n- Related projects\n- Potential Introduction\n- Potential Results\n- Potential Discussion points\n- Prior discussion points\n- Potential titles\n- Potential keywords\n- Potential abstract\n- Abbreviations\n- Potential collaborators\n- Potential competitors\n- Potential reviewers\n- Draft cover letter\n\n\n### Project Data\n\n- Inventory of data on hand\n- Inventory of project's required external software\n- Inventory of the project's software repositories\n- Relevant videos\n- Relevant blogs\n- Relevant literature sources\n- Relevant collections of PDFs\n- Project's progress summary for the annual grant report\n- Project's progress summary for the annual report to college\n\n\n### Plans to support the project\n\n- Budget\n- Relation to specific aims of funded grants.\n- Secure funding for the research and manuscript.\n- Timeline to do the required experiments to test the hypothesis. \n- Secure access to required national laboratory resources at experimental stations (i.e., general user proposal and beamtime requests).\n- Secure access to computing resources.\n- Gather the appropriate information from the literature.\n- Recruit collaborators\n- Recruit lab members to do the work.\n- Individual career development for lab members, including yourself.\n- Biosafety.\n- Authentication of key biological and chemical resources.\n- Rigorous statistical sampling and data analysis\n- Data management, including backups and archives.\n- Data sharing.\n- The NIH PEDP.\n- Advertising plan: posters, talks, seminars, YouTube videos, social media posts.\n\n\n### Project management for timely completion \n\n- Checklist for manuscript completion.\n- Timeline and Milestones.\n- Periodic assessments of the current state of the manuscript.\n\n\n### Daily entries\n\nCreate the following yasnippet snippet with the tab trigger of `daily` to auto-generate a subsection heading, property box, and index key using today's date.\nSave it to a file named daily-entry-for-writing-log inside `./snippets/org-mode`.\n\n```elisp\n# -*- coding: utf-8 -*-\n# group: writing-log\n# name: daily-entry-for-writing-log\n# key: daily\n# --\n** `(format-time-string \"%Y-%m-%d\")`\n:PROPERTIES:\n:CUSTOM_ID: `(format-time-string \"%Y-%m-%d\")`\n:END:\n#+Latex:\\index{`(format-time-string \"%Y-%m-%d\")`}\n$0\n```\n\nNow type `entry` followed by `tab` to start a new subsection for the current day's entry.\n\n\n- Daily Log\n- Update writing progress notebook\n- Update personal knowledge base\n- Timeline or Benchmarks\n- Next action\n- To be done\n- Word Count\n\n### Future additions and tangents\n\n- Ideas to consider adding to the manuscript\n  + Introduction\n  + Results\n  + Discussion\n- To be done someday\n- Spin-off writing projects\n\n\n### Guidelines, checklists, protocols, helpful hints\n\nThis part of the writing project log may require customization.\nYou may want to include project-specific protocols.\nYou may have already written down your own protocols that you want to include, or the space for such protocols may stimulate you to develop protocols for multi-step processes you must go through in your work.\nHaving those multi-step processes recorded in a protocol and readily accessible in this document increases the probability that the protocol will be followed and that you will save time by avoiding mistakes.\n\nWe have made a variant of this writing log where this section is modular.\nThe modularity eases the inclusion and exclusion of various protocols and guidelines so that you can customize this section of the writing log to be most relevant to the writing project at hand.\nSeek repositories on this website with the words modular and writing log.\n\nBelow is a list of protocols you can delete, supplement,  or expand upon.\n\n\n- Daily Protocol\n- Tips for using Overleaf\n- Protocol for running Grammarly in Overleaf\n- Guidelines for debugging the annotated bibliography\n- Graphical Abstract\n- Guidelines for benchmarks\n- Guidelines for using the Writing Progress Notebook\n- Guidelines for using a personal knowledge base\n- Protocol for wrapping up the project and archiving data.\n\n#### Standard Protocols\n\nWe store files containing established protocols in the home directory.\nThese files can be included in all writing-project log files.\nThis enables updating one file and propagating these updates to all log files.\nIn an org file, you can use the org-mode `#+INCLUDE:` or the LaTeX `\\include{}`.\nThese included files will only be injected into the log file upon export to PDF.\n\nTo inject the contents of the external file into an org-mode file so that you see the protocol in the org file, use the following function.\nIt includes the file path of the injected file and a timestamp of when the external file was injected.\n\n```elisp\n(defun org-insert-external-file (file-path)  \n  \"Insert the contents of an external file into the current org-mode file.  \nPrompts for a file path via minibuffer and includes a timestamp in a comment.\"  \n  (interactive \"fFile to be inserted: \")  \n  (let ((timestamp (format-time-string \"%Y-%m-%d %H:%M:%S\")))  \n    (insert (format \"#+BEGIN_COMMENT\\n# File %s inserted on %s\\n#+END_COMMENT\\n\\n\" file-path timestamp))  \n    (insert-file-contents file-path)  \n    (goto-char (point-max))))  \n  \n(global-set-key (kbd \"C-c S\") 'org-insert-external-file)\n```\nHere is an example of the output.\n\n```org-mode\n** Protocol to generate a bib file with only cited references\n#+BEGIN_COMMENT\n# File ~/protocols-org/bibfileCitedOnly-writing-checklist.org inserted on 2024-12-06 04:16:21\n#+END_COMMENT\n- [ ] Run the following code to generate a bib file of the papers cited in a manuscript:\n- [ ] bibtool --preserve.key.case=on -x main.aux \u003e cited.bib\n- [ ] main.tex is the manuscript file.\n- [ ] Note that the *main.aux* file is hidden on Overleaf under the \"Logs and outputs\" pulldown menu.\n- [ ] The first flag in the command will preserve the letter case in the cite key.\n```\n\nHere is a modified form of the above function that prepends the file path to the protocols directory:\n\n```elisp\n(defun org-insert-protocol-file (file-path)  \n  \"Insert the contents of a protocol file from ~/protocols-org into the current org-mode file.  \nPrompts for a file path via minibuffer and includes a timestamp in a comment.\"  \n  (interactive (list (read-file-name \"Directory `~/protocols-org/`: \" \"~/\" \"protocols-org/\")))  \n  (let ((full-path (expand-file-name file-path))  \n        (timestamp (format-time-string \"%Y-%m-%d %H:%M:%S\")))  \n    (insert (format \"#+BEGIN_COMMENT\\n# File %s inserted on %s\\n#+END_COMMENT\\n\\n\" full-path timestamp))  \n    (insert-file-contents full-path)  \n    (goto-char (point-max))))  \n  \n(global-set-key (kbd \"C-c P\") 'org-insert-protocol-file)\n```\n\nDisclosure: The last two functions were generated with Lama 3.1 70B via the Sider plugin for Google Chrome.\nThe functions were tested, and they worked as advertised.\n\n## Usage\n\n- `git clone https://github.com/MooersLab/writingLogTemplateInOrg` into the folder containing your current writing project.\n- Start Emacs, perhaps using this [Emacs configuration](https://github.com/MooersLab/dsw-2024-org-mode-init).\n- Load the writingLogTemplate.org file into Emacs via `C-x C-f`. \n\n## Configure yasnippets\n\nYou may want to enable yasnippets to make available your latex-mode and org-mode snippets while editing the writinglog.org file in org-mode.\n\n1. In your `~/.emacs.d/snippets/latex-mode`, create a file named `.yas-parents`.\n2. Add the following to this file:\n\n```elisp\nlatex-mode\norg-mode\n```\n3. Under the Yasnippets pulldown, select `reload everything` or in the minibuffer, enter `M-x yas-reload-all`.\n \n\n## Essential keybindings for editing this file in org-mode:\n  + `C-g` to abort current command.\n  + `C-x C-c` to quit Emacs\n  + `C-x C-s` to save the current document.\n  + `C-c C-e l o` to export to pdflatex and BibTeX and open the resulting PDF in the default PDF viewer.\n  + `C-x u` to undo the last change.\n  + `M-UP` or `M-DOWN` to shift lines up and down. UP and Down are the arrow keys.\n  + `C-3 S-tab` to collapse the whole document while showing headlines down to the 3rd level. Change the number to collapse to a different level.\n  + `C-x C-o` to show the outline view using consult. This is the same as `M-x consult-outline`. This consult command collapses the document into a more compact format than `C-s S-tab` command. As a result, it is easier to navigate. You have to install the consult package.\n\nThe [latex-emacs profile](https://github.com/MooersLab/latex-emacs) can access org-mode because it is built into Emacs.\n\n## Using with org-pomodoro\n\nThe daily log section is the ideal place for running a Pomodoro timer.\nThe daily entries have a property drawer.\nPlace the cursor or point below the current day's heading and enter `C-c o` to start a Pomodoro with the start and end times logged in a logbook in the property drawer.\n\n\n## Bash function for creating a writing log for a new project\n\nAt the start of a writing project, use this function to write a copy of the writing log template to a file with the project name.\nStore this Dash function in the `.bashrc` or `.zshrc` file. Oh shoot too\n\n```bash\nfunction logorg {\necho \"Copy template writing log in org with project number in title.\"\nif [ $# -lt 1 ]; then\n  echo 1\u003e\u00262 \"$0: not enough arguments\"\n  echo \"Usage1: logorg projectID\"\n  return 2\nelif [ $# -gt 1 ]; then\n  echo 1\u003e\u00262 \"$0: too many arguments\"\n  echo \"Usage1: logorg projectID\"\n  return 2\nfi\nprojectID=\"$1\"\necho \"Write writing log to log$1.org file.\"\ncp  ~/6112MooersLabGitHubLabRepos/writingLogTemplateInOrg/writingLogTemplateVer5.org log$1.org\n\n}\n```\n\n## Some relevant functions in [Mooerslab/mooereslab-functions-el](https://github.com/MooersLab/mooerslab-functions-el)\n\nThis repository contains my collection of useful functions to ease the use of this writing log and org-mode in general.\n\n- add-periods-to-list\n- org-add-periods-to-list-items\n- org-insert-protocol-file (I now store my protocols in ~/org-roam for fast discovery and recall)\n- region-to-itemized-list-in-org\n- region-to-todos-in-org\n- region-to-itemized-in-latex\n- latex-to-org-list-region\n- region-csv-to-org-table\n- create-org-table-with-caption\n- count-non-blank-lines\n- export-csv-to-sqlite-table (great for creating databases from csv files)\n- export-csv-to-matched-sqlite-table (great for adding data in csv file to existing database)\n- get-citekeys-from-bibtex-file\n- wrap-citekey-and-create-tex-file\n- insert-org-captioned-figure \n- org-convert-checkboxes-to-todos\n- org-move-to-tag\n- append-todo-to-tagged-headline\n- open-new-abibnote-on-citekey\n- split-sentences-into-lines (very useful for splitting the long line of sentences returned from the whisper-file transcription)\n\n## Directly related talks\n- [DSW 60-minute talk about scientific writing workflow in Org Mode: November 22, 2024](https://mediasite.ouhsc.edu/Mediasite/Channel/python/watch/cd5641aea892468c894ae31cd151d4671d)\n- [Slides from the above talk](https://github.com/MooersLab/DSW24-org-mode-slides)\n- [Emacs configuration associated with the above talk](https://github.com/MooersLab/dsw-2024-org-mode-init)\n\n- [EmacsConf24 20-minute talk: December 7, 2024](https://emacsconf.org/2024/talks/project/)\n\n## Related projects of possible interest\n- [Org-mode manuscript template](https://github.com/MooersLab/manuscriptInOrg)\n- [LaTeX manuscript template](https://github.com/MooersLab/manuscriptInLaTeX)\n- [Writing log template in LaTeX (compiles on Overleaf and in Emacs)](https://github.com/MooersLab/writingLogTemplate)\n- [Writing log template in reStructuredText](https://github.com/MooersLab/writing-log-rst) reStructuredText is used by programmers for documentation.\n- [Writing log template in Markdown](https://github.com/MooersLab/writing-log-md) Markdown variant. Read and rendered to PDF by most good text editors.\n- [Writing log template in ODT](https://github.com/MooersLab/writing-log-odt) ODT can be read by Open Office, LibreOffice and MS Word.\n- [Writing log template in DOCX for MS Word](https://github.com/MooersLab/writing-log-docx) MS Word variant. Probably the least suitable format for this task.\n\n- [Slideshow template in LaTeX](https://github.com/MooersLab/slideshowTemplateLaTeX)\n- [Annotated bibliography Template in LaTeX](https://github.com/MooersLab/annotatedBibliography)\n- [LaTeX manuscript template](https://github.com/MooersLab/manuscriptInLaTeX/edit/main/README.md)\n- [Org-mode manuscript template](https://github.com/MooersLab/manuscriptInOrg/edit/main/README.md)\n- [Slideshow template in LaTeX](https://github.com/MooersLab/slideshowTemplateLaTeX)\n- [Annotated bibliography Template in LaTeX](https://github.com/MooersLab/annotatedBibliography)\n- [Diary for 2024 in LaTeX](https://github.com/MooersLab/diary2024inLaTeX)- [latex-emacs profile](https://github.com/MooersLab/latex-emacs)\n- [default Emacs profile](https://github.com/MooersLab/configorg)\n- [snippets for latex-mode in Emacs](https://github.com/MooersLab/snippet-latex-mode)\n- [Quizzes about Emacs to improve recall of keybindings](https://github.com/MooersLab/qemacs)\n- [Slides from talk about GhostText, Data Science Workshop, July 2022](https://github.com/MooersLab/DSW22ghosttext)\n- [Video link to talk about GhostText, Data Science Workshop, July 2022](https://mediasite.ouhsc.edu/Mediasite/Channel/python/watch/4da0872f028c4255ae12935655e911321d)\n- [Slideshow about using LaTeX in Emacs, Berlin Emacs Meetup, 31 August 2022](https://github.com/MooersLab/BerlinEmacsAugust2022)\n- [The writer's crede](https://github.com/MooersLab/thewriterslaw)\n\n\n## Update history\n\n|Version      | Changes                                                                                      | Date                 |\n|:-----------|-----------------------------------------------------------------------------------------------|:--------------------|\n|  0.1 | First working version.                                                                              | 2022 September 10    |\n|  0.5 | Added five sections to catch up with the tex version.                                               | 2024 August 11      |\n|  0.6 | Compiles now without init.el file. Moved `Daily protocol` to `Guidelines` section. Elevated  `Daily Log` to section level. | 2024 August 18      |\n|  0.7 | Moved the comments or advice prose into a GUIDANCE drawer in each section outside of the Guidelines section. | 2024 August 21      |\n|  0.7.1 | Added subheading with noexport tag above each GUIDANCE drawer to prevent the export of their contents to the PDF.  Added the urlx package to linewrap long URLs. | 2024 August 27      |\n|  0.7.2 | Added STARTUP command to open file with the drawers closed. | 2024 September 13 |\n|  0.7.3 | Explained introduction to distinguish this tool from writing accountability tools. | 2024 October 30 |\n|  0.8.0 | Added :restart: tag to position the cursor at the end of the last daily entry in the Daily Log section upon opening the document in Emac. Made minor updates to the README.md file including link to talk about this document. | 2024 November 28 |\n| 0.8.1 | Added function to insert contents of external files. This is very cool!                            | 2024 December 6 |\n| 0.8.2 | Added :appendtodos: tag to headline above TODO list in middle of document to work with org-projects.el. Replaced Next Action with  Hemmingway Bridge.                           | 2025 March 21 |\n| 0.8.3 | Added list of useful functions found in mooerslab-functions-el                         | 2025 March 27 |\n|0.8.4.| Added section at beginning for drafting alternate central hypotheses.  | 2026 January 5|\n\n## Sources of funding\n\n- NIH: R01 CA242845\n- NIH: R01 AI088011\n- NIH: P30 CA225520 (PI: R. Mannel)\n- NIH: P20 GM103640 and P30 GM145423 (PI: A. West)\n\n\n\u003c!-- Local Variables: --\u003e\n\u003c!-- jinx-local-words: \"BibTeX\" --\u003e\n\u003c!-- End: --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmooerslab%2Fwritinglogtemplateinorg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmooerslab%2Fwritinglogtemplateinorg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmooerslab%2Fwritinglogtemplateinorg/lists"}