Coder Social home page Coder Social logo

idyll-svelte's Introduction

This repo is a proof-of-concept for porting Idyll to Svelte.

Current Idyll compiles to Markdown + custom syntax to React components and a custom runtime. It also hacks in reactive variables. Unfortunately, the hacking does not play well with React components, Idyll files are not composable, and the compiler is very brittle and doesn't give good error messages.

This port converts Idyll to an EDSL in Svelte + MDsveX. Idyll-Svelte components are composable. Svelte handles the reactive runtime and MDsveX handles the Markdown syntax. Idyll-Svelte is effectively a component library with nice CSS templates. But don't be fooled by its simplicity! This is still a wildly useful product for people (like me) who want to craft explorable explanations and other types of interactive articles. In fact, it should be much more pleasant to use in Svelte, since Svelte components should "just work" with Idyll-Svelte.

Port Status (crossed-out directories are handled by Svelte + MDsveX):

TODO: some of these components use onChange internally, but don't expose externally? Can this be removed in the Svelte version because it's an implementation detail? Or does it affect the API?

TODO: Use TypeScript

  • ast
  • cli
  • compiler
  • components
    • action
    • analytics (medium)
    • aside
    • boolean (easy)
    • button
    • case (TODO: maybe don't implement and wait for Svelte to support?)
    • chart (medium/hard)
    • cite
    • code-highlight (medium/hard. use Prism?)
    • conditional
    • default (easy)
    • desmos (medium)
    • display (TODO: figure out what the extra stuff is for and port over if needed)
    • dynamic (medium-hard)
    • equation (medium-hard)
    • fixed
    • float
    • generateHeaders (TODO: I don't think the id is user facing so it can be ignored?)
    • gist (medium)
    • graphic (not needed?)
    • h1
    • h2
    • h3
    • h4
    • h5
    • h6
    • header
    • index
    • inline
    • link (easy)
    • loop (Svelte each blocks)
    • preload (easy-medium)
    • radio (easy)
    • range
    • scroller (TODO: Currently just uses Svelte's Scroller, but could be wrapped. Also needs proper CSS)
    • select
    • step (easy-medium)
    • stepper-control (easy)
    • stepper (medium-hard)
    • svg
    • switch (TODO: maybe don't implement and wait for Svelte to support?)
    • table (medium/hard)
    • text-container (easy? not sure how it's used)
    • text-input (easy)
    • tweet (medium)
    • youtube (easy)
  • docs
  • document
  • layouts
    • blog
    • centered
    • none (when layout is undefined)
  • template projects
    • article
    • multipage
    • scrollytelling
    • slideshow
  • themes
    • default (when no theme is undefined)
    • github
    • idyll
    • none (when passed theme: false)
    • tufte

Default Svelte README below:


Looking for a shareable component template? Go here --> sveltejs/component-template


svelte app

This is a project template for Svelte apps. It lives at https://github.com/sveltejs/template.

To create a new project based on this template using degit:

npx degit sveltejs/template svelte-app
cd svelte-app

Note that you will need to have Node.js installed.

Get started

Install the dependencies...

cd svelte-app
npm install

...then start Rollup:

npm run dev

Navigate to localhost:5000. You should see your app running. Edit a component file in src, save it, and reload the page to see your changes.

By default, the server will only respond to requests from localhost. To allow connections from other computers, edit the sirv commands in package.json to include the option --host 0.0.0.0.

Building and running in production mode

To create an optimised version of the app:

npm run build

You can run the newly built app with npm run start. This uses sirv, which is included in your package.json's dependencies so that the app will work when you deploy to platforms like Heroku.

Single-page app mode

By default, sirv will only respond to requests that match files in public. This is to maximise compatibility with static fileservers, allowing you to deploy your app anywhere.

If you're building a single-page app (SPA) with multiple routes, sirv needs to be able to respond to requests for any path. You can make it so by editing the "start" command in package.json:

"start": "sirv public --single"

Deploying to the web

With now

Install now if you haven't already:

npm install -g now

Then, from within your project folder:

cd public
now deploy --name my-project

As an alternative, use the Now desktop client and simply drag the unzipped project folder to the taskbar icon.

With surge

Install surge if you haven't already:

npm install -g surge

Then, from within your project folder:

npm run build
surge public my-project.surge.sh

idyll-svelte's People

Contributors

joshpoll avatar

Stargazers

 avatar Andrejs Agejevs avatar Matt Worthington avatar Matthew Conlen avatar

Watchers

Matthew Conlen avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.