A misnomer and a mess. The IDE I want for doing knowledge work doesn't exist.
IPython (i.e Jupyter) does a lot of what I want. But,
for say, writing a dissertation, there are missing tools. Right now, PhIDE
is me writing little utilities that work good enough, kicking the quality can
down the road. You probably shouldn't use this library yet. I mean, it works,
but it's not systematically tested. (But, I do use it daily, and I have not
hand any accidental rm -rf /
incidents -- yet.)
$ pip install phide
Recursively walks the file system -- starting from the current directory --
for IPython notebooks. Following the PhIDE convention, it skips processing of
files or directories which start with a .
or _
. Ordering is lexicographic.
(I use a convention of naming notebooks as ###_name.ipynb
.) When it reads a
markdown cell, it concatenates it to the output Pandoc flavored markdown file
(_phide_output/extract.md
). When it encounters an SVG output, it serializes
it (to _phide_output/media/#.svg
) and insert an image into the markdown
file. Then, it runs pandoc.
Usage: $ phide-simple-html
I need to add support for pandoc compilation into alternative formats (e.g. latex). I especially want support for citations via IPython's data-cite convention.
It should also support more than just SVG files. And, I want it to support latex-style referencing and figures.
Oh, and templating.
Often, I want to read PDF files on my iPad using GoodReader. GoodReader offers DropBox synchronization. This script syncs PDF files used in my dissertation with those on a Dropbox. It obeys the following rules:
- If the dropbox file is newer, overwrite the dissertation one.
- If the dissertation file is newer, overwrite the dropbox one.
- If there is no equivalent file in the dropbox directory, copy it.
Note, this script "unpacks" _cited_docs
. For example, if you are working on
your thesis you may have a:
/thesis/intro/_cited_docs/transformative_hermeneutics.pdf
it syncs with
/sync_folder/intro/transformative_hermeneutics.pdf
.
WARNING: Modern Academia is a mostly a closed-source community, built upon
the idea that sharing is bad (for your CV). Part of this paradigm depends upon
journals, or tenure justifiers. These institutions do not like it when you
share research, and will prosecute those who do. Remember to add
_citeddocs
to your .gitignore
.
Usage: $ phide-paper-sync sync-dir
Probably something more robust than modified time comparisons. That seems dangerous. Also, I want it to be executable correctly from any project sub-dir, like git.