Closed vickychijwani closed 7 years ago
Hey @vickychijwani π
This is Kate from Ghost. It's very exciting for us to see how much you care about the Ghost 1.0
changes. Very impressive! Our goal is to release the beta on Thursday. It's finally happening π
I wanted to share some details about our mobiledoc editor.
The initial plan was to ship the new mobiledoc editor with 1.0
, but the complexity of edge cases and the wish to finally release 1.0
forced us to revert the editor for now. Instead we have added SimpleMDE, a new and better markdown editor, which fills this gap for now.
But the idea is still to ship the mobiledoc editor as soon as possible. And that's why we decided to keep the mobiledoc post field and mobiledoc format, to be able to switch to mobiledoc easily.
That means:
0.11.x
{
"markdown": "## headline"
}
1.0
{
"version":"0.3.1",
"markups":[],
"atoms":[],
"cards":[
["card-markdown", {
"cardName": "card-markdown",
"markdown": "# headline"
}]
],
"sections":[[10,0]] // a static value for now
}
External clients (like quill) are required to send this format for 1.0
.
We thought about keeping the ability to send/receive markdown
to/from the Ghost API, which then get's transformed into mobiledoc format, which would be easier for external clients like quill. But we would like to wait how complicated this requirement is and that the reason keeping the mobiledoc format is understood from our external clients.
Thanks so much for quill! If you have any questions, come say hello on slack!
Hi @kirrg001 π
I'm looking forward to the 1.0 beta!
Your comment clarifies the changes I would need to make, and having visibility into the Ghost team's thought process provides useful context. I'll need to dig deeper into the mobiledoc format to understand what all those fields mean, but this is a great starting point. Thank you!
I'll reach out via Slack for any questions.
Ghost 1.0 is releasing ~this month~, which means big breaking changes are imminent. I'm tracking all of the potential changes on this wiki page: https://github.com/vickychijwani/quill/wiki/Changes-for-Ghost-1.0. Specific todos will be added to this issue as they are formulated.
All work for this issue is happening in the
wip-ghost-1.0
branch.Mandatory changes
/configuration/
endpoint uses a typed-JSON dictionary, where the values can be bools, strings, or even objects.hasRefreshTokenExpired
and, indeed,hasAccessTokenExpired
since the expiry times are very long. (note: this change is also included in Ghost 0.11.5 LTS)markdown
field removed, superseded bymobiledoc
field: - see comment below and these issuespost.image
field renamed tofeature_image
user.image
field renamed toprofile_image
fileStorage: true/false
config option is going away.Bugs
Optional changes
Misc stuff