From 699982659c9473b60eb891317e22af84a43bfab6 Mon Sep 17 00:00:00 2001 From: Hans-Martin von Gaudecker Date: Tue, 1 Oct 2024 17:32:30 +0200 Subject: [PATCH] Remove more outdated stuff. --- docs_template/source/faq.md | 82 +++++-------------- .../getting_started/preparing_your_system.md | 19 +++-- .../source/getting_started/second_machine.md | 2 +- .../guides_explanations/environments.md | 3 +- inst/WORDLIST | 1 + 5 files changed, 33 insertions(+), 74 deletions(-) diff --git a/docs_template/source/faq.md b/docs_template/source/faq.md index 3474ec95..79a21436 100644 --- a/docs_template/source/faq.md +++ b/docs_template/source/faq.md @@ -6,51 +6,6 @@ ## Tips and Tricks for Windows Users -**Anaconda Installation Notes for Windows Users** - -Please follow these steps unless you know what you are doing. - -1. Download the [Graphical Installer](https://www.anaconda.com/products/distribution) - for Python 3.x. - -1. Start the installer and click yourself through the menu. If you have administrator - privileges on your computer, it is preferable to install Anaconda for all users. - Otherwise, you may run into problems when running python from your powershell. - -1. Make sure to (only) tick the following box: - - - ''Register Anaconda as my default Python 3.x''. Finish installation. - -1. Navigate to the folder containing your Anaconda distribution. This folder contains - multiple subfolders. Please add the path to the folder called `condabin` to your - *PATH* environmental variable. This path should end in `Anaconda3/condabin`. You can - add paths to your *PATH* by following these - [instructions](https://www.computerhope.com/issues/ch000549.htm). - -1. Please start Windows Powershell in administrator mode, and execute the following: - - ```bash - $ set-executionpolicy remotesigned - ``` - -1. Now (re-)open Windows Powershell and initialize it for full conda use by running - - ```bash - $ conda init - ``` - -```{warning} If you still run into problems when running conda and python from -powershell, it is advisable to use the built-in Anaconda Prompt instead. -``` - -(git_windows)= - -### Integrating git tab completion in Windows Powershell - -Powershell does not support tab completion for git automatically. However, there is a -nice utility called [posh-git](https://github.com/dahlbyk/posh-git). We advise you to -install this as this makes your life easier. - (path_windows)= ### PATH environmental variable in Windows @@ -64,38 +19,41 @@ how to do that. ### Adding directories to the PATH: MacOS and Linux -Open the program **Terminal**. You will need to add a line to the file `.bash_profile` -and potentially create the file. This file lives in your home directory, in the Finder -it is hidden from your view by default. +Open the program **Terminal**. First, you will need to determine the shell you are +using: -**Linux users**: For most distributions, everything here applies to the file `.bashrc` -instead of `.bash_profile`. +```zsh +echo $SHELL +``` -I will now provide a step-by-step guide of how to create / adjust this file using the -editor called `code`. If you are familiar with editing text files, just use your editor -of choice. +The output will be something like `/bin/bash` or `/bin/zsh`. Depending on the output, +the below applies either to the file `.bashrc` or `.zshrc`. Both of them live in your +home directory and are read every time you open a new terminal. + +I will now provide a step-by-step guide of how to create / adjust the file `.zshrc` +using the editor [VS Code](https://code.visualstudio.com/), which you can typically +start from a shell by typing `code`. If you are familiar with editing text files, just +use your editor of choice. If you are using a `bash` shell, replace `.zshrc` with +`.bashrc` in the following. 1. Open a Terminal and type - ```bash - code ~/.bash_profile + ```zsh + code ~/.zshrc ``` - If you use an editor other than [VS Code](https://code.visualstudio.com/), replace - `code` by the respective editor. - - If `.bash_profile` already existed, you will see some text at this point. If so, use - the arrow keys to scroll all the way to the bottom of the file. + If `.zshrc` already existed, you will see some text at this point. If so, use the + arrow keys to scroll all the way to the bottom of the file. 1. Add the following line at the end of the file - ```bash + ```zsh export PATH="${PATH}:/path/to/program/inside/package" ``` You will need to follow the same steps as before. Example for Stata: - ```bash + ```zsh # Stata directory export PATH="${PATH}:/Applications/Stata/StataMP.app/Contents/MacOS/" ``` diff --git a/docs_template/source/getting_started/preparing_your_system.md b/docs_template/source/getting_started/preparing_your_system.md index 0e28dc27..c1cc1d69 100644 --- a/docs_template/source/getting_started/preparing_your_system.md +++ b/docs_template/source/getting_started/preparing_your_system.md @@ -23,10 +23,10 @@ path. This template requires If you are on Windows, please open the Windows Powershell. On Mac or Linux, open a terminal. As everything will be started from the Powershell/Terminal, you need to make -sure that all programmes you need in your project (for sure Anaconda Python, Git, and -LaTeX; potentially VS Code, R, Julia, Stata) can be found on your *PATH*. That is, these -need to be accessible from your shell. This often requires a bit of manual work, in -particular on Windows. +sure that all programmes you need in your project (for sure Python obtained via +Miniforge, Git, and LaTeX; potentially VS Code, R, Julia, Stata) can be found on your +*PATH*. That is, these need to be accessible from your shell. This often requires a bit +of manual work, in particular on Windows. - To see which programmes can be found on your path, type (leave out the leading dollar sign, this is just standard notation for a command line prompt): @@ -46,10 +46,11 @@ particular on Windows. This gives you a list of directories that are available on your *PATH*. - Check that this list contains the path to the programs you want to use in your - project, in particular, Anaconda (this contains your Python distribution), a LaTeX - distribution, the text editor VS Code, Git, and any other program that you need for - your project (R, Julia, Stata). Otherwise add them by looking up their paths on your - computer and follow the steps described here {ref}`path_windows` or {ref}`path_mac`. + project, in particular, Miniforge (this contains the required Python distribution), a + LaTeX distribution, the text editor VS Code, Git, and any other program that you need + for your project (R, Julia, Stata). Otherwise, add them by looking up their paths on + your computer and follow the steps described here {ref}`path_windows` or + {ref}`path_mac`. - If you added any directory to *PATH*, you need to close and reopen your shell, so that this change is implemented. @@ -63,7 +64,7 @@ particular on Windows. ``` This starts python in your shell and exits from it again. The top line should indicate - that you are using a Python distribution provided by Anaconda. Here is an example + that you are using a Python distribution provided by conda-forge. Here is an example output obtained on Linux: ```text diff --git a/docs_template/source/getting_started/second_machine.md b/docs_template/source/getting_started/second_machine.md index 9d6b67ae..18d90f92 100644 --- a/docs_template/source/getting_started/second_machine.md +++ b/docs_template/source/getting_started/second_machine.md @@ -3,7 +3,7 @@ very easy to invite a collaborator or to use a second machine. Importantly you d need to create the template repository again. On the second machine prepare the system and open a terminal on Mac/Linux or the -Anaconda prompt on Windows. Then type +Powershell on Windows. Then type ```console $ git clone diff --git a/docs_template/source/guides_explanations/environments.md b/docs_template/source/guides_explanations/environments.md index ead5bfb7..2310cb15 100644 --- a/docs_template/source/guides_explanations/environments.md +++ b/docs_template/source/guides_explanations/environments.md @@ -8,8 +8,7 @@ The solution is to have isolated environments on a per-project basis. allow you to do precisely this. This page describes them a little bit and explains their use. -The following commands can either be executed in a terminal or the Anaconda prompt -(Windows). +The following commands can either be executed in a terminal or the Powershell (Windows). ### Using the environment diff --git a/inst/WORDLIST b/inst/WORDLIST index ebeea4be..98436d42 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -1571,6 +1571,7 @@ mI Micromamba MikTex Miniconda +Miniforge minimises mIw mj