{"id":21478963,"url":"https://github.com/mjpost/nvalt-files","last_synced_at":"2025-07-15T11:31:28.066Z","repository":{"id":16749498,"uuid":"19507095","full_name":"mjpost/nvalt-files","owner":"mjpost","description":"nvALT preview templates and image archiving service","archived":false,"fork":false,"pushed_at":"2015-08-21T12:03:14.000Z","size":635,"stargazers_count":29,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-09T03:11:33.612Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mjpost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-05-06T19:09:29.000Z","updated_at":"2020-06-19T17:00:00.000Z","dependencies_parsed_at":"2022-07-14T11:47:14.557Z","dependency_job_id":null,"html_url":"https://github.com/mjpost/nvalt-files","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mjpost/nvalt-files","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjpost%2Fnvalt-files","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjpost%2Fnvalt-files/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjpost%2Fnvalt-files/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjpost%2Fnvalt-files/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mjpost","download_url":"https://codeload.github.com/mjpost/nvalt-files/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjpost%2Fnvalt-files/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265431547,"owners_count":23764031,"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":[],"created_at":"2024-11-23T11:20:19.199Z","updated_at":"2025-07-15T11:31:27.634Z","avatar_url":"https://github.com/mjpost.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"### nvALT configuration files\n\nI use nvALT extensively for research notes.  The files in this archive\nprovide these functions:\n\n- [Bootstrap](http://getbootstrap.com)-based,\n  [MathJAX](http://www.mathjax.org)-enabled templates for previews\n- An Automator workflow implementing a Finder service that archives\n  image files to a canonical location and copies a\n  [Markdown](http://daringfireball.net/projects/markdown/)-formatted\n  image URL to that image, enabling each incorporation of images.\n\nHere is an example of the nvALT window with a MathJAX-enabled preview:\n\n![](images/example.png)\n\nThese templates began with templates\n[published by Brett Terpstra](http://brettterpstra.com/2013/04/06/customizing-the-nvalt-preview/). I\nmodified them to remove evidence of the \"Lopash\" them and to add\nsupport for [MathJAX](http://www.mathjax.org).\n\n### What you'll get\n\n* Support for [MathJAX](http://www.mathjax.org) in notes\n* Automatic highlighting of code blocks with [highlight.js](http://softwaremaniacs.org/soft/highlight/en/)\n* A basic implementation of [Widon't](http://shauninman.com/archive/2006/08/22/widont_wordpress_plugin) for headlines.\n* Smooth scrolling when clicking footnotes and anchors.\n* A \"back to top\" link that appears when scrolling down a note.\n\n### Installation\n\n0. Download and install [nvALT](http://brettterpstra.com/projects/nvalt/).\n\n1. First, back up any custom files you've created previously. These\nfiles are located under `$HOME/Library/Application Support/nvALT/`.\n\n        $ cd \"$HOME/Library/Application Support/\"\n        $ mv nvALT nvALT.bak\n\n2. Move or download this archive to that location:\n\n        $ cd \"$HOME/Library/Application Support/\"\n        $ git clone git@github.com:mjpost/nvALT-files nvALT\n\n3. Download and install MathJAX to the directory `mathjax` in the\n`nvALT` directory above.\n\n   You should now have the following files in your Support folder:\n\n        custom.css\n        highlight.pack.js\n        jquery.min.js\n        template.html\n        mathjax/\n          README.md\n          MathJax.js\n          ...\n\n4. Install the Automator workflow by double-clicking on the file\n`nvALT archive.workflow`. \n\n5. Install a keyboard shortcut for the workflow. Place it under System Preferences →\nKeyboard → Shortcuts → App Shortcuts → All Applications. The name\nshould be \"nvALT archive\" (exactly). I use ^⌘a as my shortcut.\n\n   Now, on any image file in Finder, you can click this shortcut (or\n   select it from the Finder Services menu. The image will be copied\n   to a directory within `$HOME/Library/Application\n   Support/nvALT/Media/{YEAR}/{MONTH}`, and a Markdown-formatted relative path to this\n   file will be placed on the clipboard, to be pasted into your nvALT document.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmjpost%2Fnvalt-files","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmjpost%2Fnvalt-files","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmjpost%2Fnvalt-files/lists"}