writing_paper.md

About Writing Academic Paper

Basics

• Notes on writing papers by Prof. Alexie Leauthaud

Examples

• Good example of papers with good reproducibility:
  • STARRY: Analytic Occultation Light Curves
  • Format, equation, figure, open source code, and awesomefont links.

English

• Grammarly
• Linguee - Good place to search for example usage of a word
• Linggle 10^12 - Another place to search for real world usage of a word

Useful Tools

• bibmanager - A BibTeX manager for LaTeX projects

  • By Patricio Cubillos; a command-line application to maintain a database of references (BibTeX and PDFs) that automates generating .bib files when compiling LaTeX projects; as well as search, sync, and fetch from ADS.

• adstex - manage your bibtex entries

  • By Yao-Yuan Mao; Automated generation of NASA ADS bibtex entries directly from citation keys in your TeX source files

• The Astronomy Acknowledgement Generator

  • This is very useful! The data are kept here

• PDF Compressor

  • This is useful when you want to compress the quality of a figure.

• Tabula - Tool for liberating data tables locked inside PDF files

LaTeX

Online LaTeX Editor

• Overleaf

  • The most commonly used one. The free service is already very good.

• Authorea

  • A powerful publishing platform for articles, data, figures, preprints. More than just a LaTeX editor.

LaTeX resources

• Complete list of LaTeX symbols (PDF)

• List of LaTeX mathematical symbols

• LaTeX open book on WikiBooks

  • Very good place to search for basic usage.

• List of color names in LaTeX along with other useful tips about color

Useful LaTeX tips

• Link to aribitary part of text
  • Using \hypertarget and \hyperlink

Figure

Flowchart

• mermaid - Generation of diagram and flowchart from text in a similar manner as markdown
  • mermaid, a simple markdown-like script language for generating charts from text via javascript.