From 6fed414c0920cd45f65bf612ff6f1ff67ff7c102 Mon Sep 17 00:00:00 2001 From: allanaaa Date: Thu, 14 Jan 2021 13:12:21 -0500 Subject: [PATCH] Mac instruction changes, autosave changes --- docs/docs/manual/columnediting.md | 2 +- docs/docs/manual/installing.md | 24 ++---------------------- docs/docs/manual/running.md | 19 +++++++++++++++---- docs/docs/manual/starting.md | 2 ++ 4 files changed, 20 insertions(+), 27 deletions(-) diff --git a/docs/docs/manual/columnediting.md b/docs/docs/manual/columnediting.md index 470db2441..59be6d82e 100644 --- a/docs/docs/manual/columnediting.md +++ b/docs/docs/manual/columnediting.md @@ -65,7 +65,7 @@ Through the Add column by fetching URLs function, If you have a column of URLs and want to fetch the information that they point to, you can simply run the expression as `value`. If your column has, for example, unique identifiers for Wikidata entities (numerical values starting with Q), you can download the JSON-formatted metadata about each entity with ``` -“https://www.wikidata.org/wiki/Special:EntityData/” + value + “.json” +"https://www.wikidata.org/wiki/Special:EntityData/" + value + ".json" ``` or whatever metadata format you prefer. Information about the format options in Wikidata can be found [here](https://www.wikidata.org/wiki/Wikidata:Data_access). The service you are fetching data from may have similar documentation on its provided options. diff --git a/docs/docs/manual/installing.md b/docs/docs/manual/installing.md index 87d274470..181c2890d 100644 --- a/docs/docs/manual/installing.md +++ b/docs/docs/manual/installing.md @@ -392,32 +392,12 @@ You can change this when you run OpenRefine from the terminal, by pointing to th ### Logs -OpenRefine does not currently output an error log, but because the OpenRefine console window is always open while OpenRefine runs in your browser, you can copy information from the console if an error occurs. +OpenRefine does not currently output an error log, but because the OpenRefine console window is always open (on Linux and Windows) while OpenRefine runs in your browser, you can copy information from the console if an error occurs. - - - - -You can access OpenRefine server logs from the terminal on Mac: - -* Find the OpenRefine app/icon in Finder -* control-click on the icon and select “Show Package Contents” from the context menu that displays -* This should open a new Finder menu showing a folder called “Contents” - navigate into this folder then into the “MacOS” folder -* control-click on “JavaAppLauncher” -* Choose “Open With” from the menu, and select “Terminal” +Using a Mac, you can [run OpenRefine using the terminal](running#starting-and-exiting) in order to capture errors. --- - - - - ## Increasing memory allocation OpenRefine relies on having computer memory available to it to work effectively. If you are planning to work with large datasets, you may wish to set up OpenRefine to handle it at the outset. By “large” we generally mean one of the following indicators: diff --git a/docs/docs/manual/running.md b/docs/docs/manual/running.md index f5782115d..efdd57469 100644 --- a/docs/docs/manual/running.md +++ b/docs/docs/manual/running.md @@ -56,7 +56,14 @@ To exit OpenRefine, close all the browser tabs or windows, then navigate to the -You can find OpenRefine in your Applications folder, or you can call it from the command line with `./refine`. +You can find OpenRefine in your Applications folder, or you can open it using Terminal. + +To run OpenRefine using Terminal: +* Find the OpenRefine application / icon in Finder +* Control-click on the icon and select “Show Package Contents” from the context menu +* This should open a new Finder menu: navigate into the “MacOS” folder +* Control-click on “JavaAppLauncher” +* Choose “Open With” from the menu, and select “Terminal.” To exit, close all your OpenRefine browser tabs, go back to the terminal window and press `Command` and `Q` to close it down. @@ -416,7 +423,7 @@ You can preserve your facets and filters for future use by copying a Undo/Redo, you will lose it when you leave the project workspace. +Autosaving happens by default every five minutes. You can [change this preference by following these directions](running#jvm-preferences). + You can only save and share facets and filters, not any other type of view. To save current facets and filters, click Permalink. The project will reload with a different URL, which you can then copy and save elsewhere. This permalink will save both the facets and filters you’ve set, and the settings for each one (such as sorting by count rather than by name). ### Deleting projects