kopia lustrzana https://github.com/simonw/datasette
'Try Datasette without installing anything using Glitch'
Also new 'Play with a live demo' section, both at the top of the Getting Started documentation page. https://datasette.readthedocs.io/en/latest/getting_started.html Closes #464pull/479/head
rodzic
666c37415a
commit
623c552ff4
|
@ -1,8 +1,42 @@
|
|||
Getting started
|
||||
===============
|
||||
|
||||
Basic usage
|
||||
-----------
|
||||
Play with a live demo
|
||||
---------------------
|
||||
|
||||
The best way to experience Datasette for the first time is with a demo:
|
||||
|
||||
* `fivethirtyeight.datasettes.com <https://fivethirtyeight.datasettes.com/fivethirtyeight>`__ shows Datasette running against over 400 datasets imported from the `FiveThirtyEight GitHub repository <https://github.com/fivethirtyeight/data>`__.
|
||||
* `sf-trees.datasettes.com <https://sf-trees.datasettes.com/trees/Street_Tree_List>`__ demonstrates the `datasette-cluster-map <https://github.com/simonw/datasette-cluster-map>`__ plugin running against 190,000 trees imported from `data.sfgov.org <https://data.sfgov.org/City-Infrastructure/Street-Tree-List/tkzw-k3nq>`__.
|
||||
|
||||
.. _glitch:
|
||||
|
||||
Try Datasette without installing anything using Glitch
|
||||
------------------------------------------------------
|
||||
|
||||
`Glitch <https://glitch.com/>`__ is a free online tool for building web apps directly from your web browser. You can use Glitch to try out Datasette without needing to install any software on your own computer.
|
||||
|
||||
Here's a demo project on Glitch which you can use as the basis for your own experiments:
|
||||
|
||||
`glitch.com/~datasette-csvs <https://glitch.com/~datasette-csvs>`__
|
||||
|
||||
Glitch allows you to "remix" any project to create your own copy and start editing it in your browser. You can also remix the ``datasette-csvs`` project by clicking this button:
|
||||
|
||||
.. image:: https://cdn.glitch.com/2703baf2-b643-4da7-ab91-7ee2a2d00b5b%2Fremix-button.svg
|
||||
:target: https://glitch.com/edit/#!/remix/datasette-csvs
|
||||
|
||||
Find a CSV file and drag it onto the Glitch file explorer panel - ``datasette-csvs`` will automatically convert it to a SQLite database (using `csvs-to-sqlite <https://github.com/simonw/csvs-to-sqlite>`__) and allow you to start exploring it using Datasette.
|
||||
|
||||
If your CSV file has a ``latitude`` and ``longitude`` column you can visualize it on a map by uncomminting the ``datasette-cluster-map`` line in the ``requirements.txt`` file using the Glitch file editor.
|
||||
|
||||
Need some data? Try this `Public Art Data <https://data.seattle.gov/Community/Public-Art-Data/j7sn-tdzk>`__ for the city of Seattle - hit "Export" and select "CSV" to download it as a CSV file.
|
||||
|
||||
For more on how this works, see `Running Datasette on Glitch <https://simonwillison.net/2019/Apr/23/datasette-glitch/>`__.
|
||||
|
||||
Using Datasette on your own computer
|
||||
------------------------------------
|
||||
|
||||
First, follow the :ref:`installation` instructions. Now you can run Datasette against a SQLite file on your computer using the following command:
|
||||
|
||||
::
|
||||
|
||||
|
|
|
@ -3,6 +3,9 @@
|
|||
Installation
|
||||
============
|
||||
|
||||
.. note::
|
||||
If you just want to try Datasette out you don't need to install anything: see :ref:`glitch`
|
||||
|
||||
There are two main options for installing Datasette. You can install it directly
|
||||
on to your machine, or you can install it using Docker.
|
||||
|
||||
|
|
Ładowanie…
Reference in New Issue