Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Using MyST and Curvenote #1

Open
rly opened this issue Mar 29, 2024 · 3 comments
Open

Using MyST and Curvenote #1

rly opened this issue Mar 29, 2024 · 3 comments

Comments

@rly
Copy link
Collaborator

rly commented Mar 29, 2024

@sneakers-the-rat - You suggested writing in MyST and using Curvenote. Writing in MyST sounds great. What aspect of Curvenote were you thinking?

There is Curvenote the platform which supports collaborative editing and commenting (no suggestion mode or track changes diff though), publishing as a website, and exporting to LaTeX, but it seems like the raw MyST document is stored on their servers. There does not seem to be a way to connect the CurveNote platform to a raw MyST document stored in a personal GitHub account.

There is Curvenote the editor which is locally installable and which we can use to edit MyST documents in this repo. I think collaborative editing and commenting would be limited to git commits, merges, and pull requests. Maybe comments could also be synced through git? I can't tell. There is also a GitHub Action that publishes the MyST doc to Curvenote as a website, but I think that is a one-way export. I imagine the local editor and other CLI tools support exporting to LaTeX.

How were you thinking of using Curvenote and doing collaborative editing on MyST docs? I am fine with either.

@rly
Copy link
Collaborator Author

rly commented Apr 12, 2024

Look into https://manubot.org/ as well - github actions can convert the markdown into a pdf

@sneakers-the-rat
Copy link
Collaborator

I was just thinking of some live-editable platform that we could use in addition to the base markdown :). here one sec i'll get the paper set up and we can see how we like it

@sneakers-the-rat
Copy link
Collaborator

In trying to get the initial structure sorted in init-myst i ran into a bunch of weird awkward pieces trying to get it to build for both web and PDF - needing to set metadata in multiple places, not being able to set root directory, etc.

I might as well try and PR fixes upstream as we go, and we will probably want to customize the build process a bit when making web vs PDF, but for now i think this'll work, at least in the sense that "if we write it in markdown in this way we won't have some catastrophic loss of work or buy ourselves an expensive refactor later"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants