Browse Source

update 2.4.3 👉🏼 3.0.0 and React 17.0.2 👉🏼 18.2.0

windhamdavid 1 year ago
parent
commit
1021aa715e
7 changed files with 66 additions and 36 deletions
  1. 3 1
      docs/editors/git.md
  2. 4 6
      docs/lang/Rust.md
  3. 16 15
      docs/server/htop.md
  4. 3 2
      docs/shell/bash.md
  5. 3 0
      docs/shell/zsh.md
  6. 2 2
      lists/tweets_follow.md
  7. 35 10
      src/pages/help.md

+ 3 - 1
docs/editors/git.md

@@ -1,4 +1,5 @@
 # git
 # git
+
 * [https://git-scm.com/](https://git-scm.com/)
 * [https://git-scm.com/](https://git-scm.com/)
 
 
 ### Notes:
 ### Notes:
@@ -202,9 +203,10 @@ $ git stash apply
 ```
 ```
 
 
 #### Restore particular stash back to current branch:
 #### Restore particular stash back to current branch:
+```shell
 - *{stash_number}* can be obtained from `git stash list`
 - *{stash_number}* can be obtained from `git stash list`
 
 
-```shell
+
 $ git stash apply stash@{stash_number}
 $ git stash apply stash@{stash_number}
 ```
 ```
 
 

+ 4 - 6
docs/lang/Rust.md

@@ -4,10 +4,7 @@
 * [https://doc.rust-lang.org/book/](https://doc.rust-lang.org/book/)
 * [https://doc.rust-lang.org/book/](https://doc.rust-lang.org/book/)
 
 
 
 
-```
 #### notes ####
 #### notes ####
-
-```
 ---
 ---
 
 
 
 
@@ -925,10 +922,10 @@ Custom errors & types in Response
     }
     }
 ```
 ```
 Configure Rocket.toml
 Configure Rocket.toml
-
+```
     [global.databases]
     [global.databases]
     doodlebase = {url = "postgres://acct:pw@localhost/dbname"}
     doodlebase = {url = "postgres://acct:pw@localhost/dbname"}
-
+```
 ### Sessions
 ### Sessions
 ```
 ```
     //in session.rs
     //in session.rs
@@ -976,7 +973,7 @@ Configure Rocket.toml
     )
     )
 ```
 ```
 ## CLI
 ## CLI
-
+```
 **Crate**: clap
 **Crate**: clap
 
 
     use clap::{clap_app, crate_version};
     use clap::{clap_app, crate_version};
@@ -1002,3 +999,4 @@ Configure Rocket.toml
     				// access value:
     				// access value:
     	      sub.value_of("field_1").unwrap()
     	      sub.value_of("field_1").unwrap()
     }
     }
+```

+ 16 - 15
docs/server/htop.md

@@ -1,15 +1,15 @@
 
 
 
 
 #### **NAME**
 #### **NAME**
-
+```
        htop - interactive process viewer
        htop - interactive process viewer
-
+```
 #### **SYNOPSIS**
 #### **SYNOPSIS**
-
+```
        **htop** **\[**\-dChusv\]
        **htop** **\[**\-dChusv\]
-
+```
 #### **DESCRIPTION**
 #### **DESCRIPTION**
-
+```
        Htop is a free (GPL) ncurses-based process viewer for Linux.
        Htop is a free (GPL) ncurses-based process viewer for Linux.
 
 
        It is similar to top, but allows you to scroll vertically and horizontally, so you can see
        It is similar to top, but allows you to scroll vertically and horizontally, so you can see
@@ -18,9 +18,9 @@
        once.
        once.
 
 
        Tasks related to processes (killing, renicing) can be done without entering their PIDs.
        Tasks related to processes (killing, renicing) can be done without entering their PIDs.
-
+```
 #### **COMMAND-LINE** **OPTIONS**
 #### **COMMAND-LINE** **OPTIONS**
-
+```
        Mandatory arguments to long options are mandatory for short options too.
        Mandatory arguments to long options are mandatory for short options too.
 
 
        **\-d** **\--delay=DELAY**
        **\-d** **\--delay=DELAY**
@@ -43,9 +43,9 @@
 
 
        **\-v** **\--version**
        **\-v** **\--version**
               Output version information and exit
               Output version information and exit
-
+```
 #### **INTERACTIVE** **COMMANDS**
 #### **INTERACTIVE** **COMMANDS**
-
+```
        The following commands are supported while in htop:
        The following commands are supported while in htop:
 
 
        **Up,** **Alt-k**
        **Up,** **Alt-k**
@@ -168,9 +168,9 @@
 
 
        **Numbers**
        **Numbers**
             PID search: type in process ID and the selection highlight will be moved to it.
             PID search: type in process ID and the selection highlight will be moved to it.
-
+```
 #### **COLUMNS**
 #### **COLUMNS**
-
+```
        The  following columns can display data about each process. A value of '-' in all the rows
        The  following columns can display data about each process. A value of '-' in all the rows
        indicates that a column is unsupported on your system, or currently unimplemented in htop.
        indicates that a column is unsupported on your system, or currently unimplemented in htop.
        The  names below are the ones used in the "Available Columns" section of the setup screen.
        The  names below are the ones used in the "Available Columns" section of the setup screen.
@@ -351,9 +351,9 @@
 
 
        **All** **other** **flags**
        **All** **other** **flags**
             Currently unsupported (always displays '-').
             Currently unsupported (always displays '-').
-
+```
 #### **CONFIG** **FILE**
 #### **CONFIG** **FILE**
-
+```
        By  default htop reads its configuration from the XDG-compliant path [~/.config/htop/htoprc](file:~/.config/htop/htoprc)
        By  default htop reads its configuration from the XDG-compliant path [~/.config/htop/htoprc](file:~/.config/htop/htoprc)
        -- the configuration file is overwritten by htop's in-program Setup configuration,  so  it
        -- the configuration file is overwritten by htop's in-program Setup configuration,  so  it
        should  not be hand-edited. If no user configuration exists htop tries to read the system-
        should  not be hand-edited. If no user configuration exists htop tries to read the system-
@@ -363,12 +363,13 @@
        You  may  override  the  location  of the configuration file using the $HTOPRC environment
        You  may  override  the  location  of the configuration file using the $HTOPRC environment
        variable (so you can have multiple configurations for different machines  that  share  the
        variable (so you can have multiple configurations for different machines  that  share  the
        same home directory, for example).
        same home directory, for example).
-
+```
 #### **MEMORY** **SIZES**
 #### **MEMORY** **SIZES**
-
+```
        Memory  sizes  in htop are displayed as they are in tools from the GNU Coreutils (when ran
        Memory  sizes  in htop are displayed as they are in tools from the GNU Coreutils (when ran
        with the --human-readable option). This means that sizes are printed in  powers  of  1024.
        with the --human-readable option). This means that sizes are printed in  powers  of  1024.
        (e.g., 1023M = 1072693248 Bytes)
        (e.g., 1023M = 1072693248 Bytes)
 
 
        The  decision  to  use this convention was made in order to conserve screen space and make
        The  decision  to  use this convention was made in order to conserve screen space and make
        memory size representations consistent throughout htop.
        memory size representations consistent throughout htop.
+```

+ 3 - 2
docs/shell/bash.md

@@ -449,7 +449,7 @@ trap returntrap RETURN  -is executed each time a shell function or a script exec
 
 
 ### COLORS AND BACKGROUNDS 
 ### COLORS AND BACKGROUNDS 
 ---
 ---
-
+```
 -Reset  
 -Reset  
 Color_Off='\033[0m' -Text Reset  
 Color_Off='\033[0m' -Text Reset  
   
   
@@ -507,4 +507,5 @@ On_White='\033[47m' -White
 -Example of usage  
 -Example of usage  
 echo -e "${Green}This is GREEN text${Color_Off} and normal text"  
 echo -e "${Green}This is GREEN text${Color_Off} and normal text"  
 echo -e "${Red}${On_White}This is Red test on White background${Color_Off}"   
 echo -e "${Red}${On_White}This is Red test on White background${Color_Off}"   
-  
+
+```

+ 3 - 0
docs/shell/zsh.md

@@ -14,6 +14,8 @@ upgrade_oh_my_zsh
 [Source](https://github.com/robbyrussell/oh-my-zsh/wiki/Cheatsheet "Permalink to Cheatsheet · robbyrussell/oh-my-zsh Wiki · GitHub")
 [Source](https://github.com/robbyrussell/oh-my-zsh/wiki/Cheatsheet "Permalink to Cheatsheet · robbyrussell/oh-my-zsh Wiki · GitHub")
 ##  Commands
 ##  Commands
 
 
+```
+
 | Command               | Description                                                                                                                  |  
 | Command               | Description                                                                                                                  |  
 | --------------------- | ---------------------------------------------------------------------------------------------------------------------------- |  
 | --------------------- | ---------------------------------------------------------------------------------------------------------------------------- |  
 | _tabs_                | Create a new tab in the current directory (macOS - requires enabling access for assistive devices under System Preferences). |  
 | _tabs_                | Create a new tab in the current directory (macOS - requires enabling access for assistive devices under System Preferences). |  
@@ -25,6 +27,7 @@ upgrade_oh_my_zsh
 | source ~/.zshrc       | Uptake new changes                                                                                                           |  
 | source ~/.zshrc       | Uptake new changes                                                                                                           |  
 
 
 * * *
 * * *
+```
 
 
 | Alias   | Command                               |  
 | Alias   | Command                               |  
 | ------- | ------------------------------------- |  
 | ------- | ------------------------------------- |  

+ 2 - 2
lists/tweets_follow.md

@@ -327,7 +327,7 @@ hide_table_of_contents: true
 |@jmar777|Jeremy Martin|Software Engineer @ https://t.co/nOEWl36YTW ༶ Full-time Programmer ༶ Part-time Ranter ༶ Traveler ༶ Photographer ༶ AI Art ༶ Husband ༶ Father ༶ Simul Iustus et Peccator|
 |@jmar777|Jeremy Martin|Software Engineer @ https://t.co/nOEWl36YTW ༶ Full-time Programmer ༶ Part-time Ranter ༶ Traveler ༶ Photographer ༶ AI Art ༶ Husband ༶ Father ༶ Simul Iustus et Peccator|
 |@jmvidal|Jose M Vidal|Professor Computer Science and Engineering U. of South Carolina.|
 |@jmvidal|Jose M Vidal|Professor Computer Science and Engineering U. of South Carolina.|
 |@joaoflux|joaoflux|(almost) unborable flow artist & bullshit designer|
 |@joaoflux|joaoflux|(almost) unborable flow artist & bullshit designer|
-|@joewalnes|Joe Walnes|{SoftwareHardwareDeveloperDesignerMakerInventor}Work at Apple on future technology. Come join me.Previously: {GoogleThoughtWorksTradingFounder}|
+|@joewalnes|Joe Walnes| SoftwareHardwareDeveloperDesignerMakerInventor Work at Apple on future technology. Come join me.Previously: GoogleThoughtWorksTradingFounder|
 |@joe_hoyle|Joe Hoyle|Co-founder & CTO @humanmadeltd @altisdxp @joehoyle@fosstodon.org|
 |@joe_hoyle|Joe Hoyle|Co-founder & CTO @humanmadeltd @altisdxp @joehoyle@fosstodon.org|
 |@johndbritton|John Britton|Founder of https://t.co/cGji88bEuP (@raisedevs) – Developer and Educator. Curious. College escapee. World traveling vagabond. Past: @github @p2pu @mozilla @twilio.|
 |@johndbritton|John Britton|Founder of https://t.co/cGji88bEuP (@raisedevs) – Developer and Educator. Curious. College escapee. World traveling vagabond. Past: @github @p2pu @mozilla @twilio.|
 |@JohnDCook|John D. Cook|I turn business problems into math problems then solve them.|
 |@JohnDCook|John D. Cook|I turn business problems into math problems then solve them.|
@@ -1017,7 +1017,7 @@ hide_table_of_contents: true
 |@jmar777|Jeremy Martin|Software Engineer @ https://t.co/nOEWl36YTW ༶ Full-time Programmer ༶ Part-time Ranter ༶ Traveler ༶ Photographer ༶ AI Art ༶ Husband ༶ Father ༶ Simul Iustus et Peccator|
 |@jmar777|Jeremy Martin|Software Engineer @ https://t.co/nOEWl36YTW ༶ Full-time Programmer ༶ Part-time Ranter ༶ Traveler ༶ Photographer ༶ AI Art ༶ Husband ༶ Father ༶ Simul Iustus et Peccator|
 |@jmvidal|Jose M Vidal|Professor Computer Science and Engineering U. of South Carolina.|
 |@jmvidal|Jose M Vidal|Professor Computer Science and Engineering U. of South Carolina.|
 |@joaoflux|joaoflux|(almost) unborable flow artist & bullshit designer|
 |@joaoflux|joaoflux|(almost) unborable flow artist & bullshit designer|
-|@joewalnes|Joe Walnes|{SoftwareHardwareDeveloperDesignerMakerInventor}Work at Apple on future technology. Come join me.Previously: {GoogleThoughtWorksTradingFounder}|
+|@joewalnes|Joe Walnes|SoftwareHardwareDeveloperDesignerMakerInventor Work at Apple on future technology. Come join me.Previously: GoogleThoughtWorksTradingFounder|
 |@joe_hoyle|Joe Hoyle|Co-founder & CTO @humanmadeltd @altisdxp @joehoyle@fosstodon.org|
 |@joe_hoyle|Joe Hoyle|Co-founder & CTO @humanmadeltd @altisdxp @joehoyle@fosstodon.org|
 |@johndbritton|John Britton|Founder of https://t.co/cGji88bEuP (@raisedevs) – Developer and Educator. Curious. College escapee. World traveling vagabond. Past: @github @p2pu @mozilla @twilio.|
 |@johndbritton|John Britton|Founder of https://t.co/cGji88bEuP (@raisedevs) – Developer and Educator. Curious. College escapee. World traveling vagabond. Past: @github @p2pu @mozilla @twilio.|
 |@JohnDCook|John D. Cook|I turn business problems into math problems then solve them.|
 |@JohnDCook|John D. Cook|I turn business problems into math problems then solve them.|

+ 35 - 10
src/pages/help.md

@@ -51,16 +51,6 @@ npm run serve
 
 
 **23/11/12** - Docusaurus updated 2.4.3 👉🏼 3.0.0 and React 17.0.2 👉🏼 18.2.0
 **23/11/12** - Docusaurus updated 2.4.3 👉🏼 3.0.0 and React 17.0.2 👉🏼 18.2.0
 
 
-:::danger
-
-This introduced a bunch of breaking errors in the markdown formatting via the MDX formatting that are documented at:
-- [https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3](https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3)
-- [https://github.com/facebook/docusaurus/discussions/9312](https://github.com/facebook/docusaurus/discussions/9312). 
-
-Went in and cleaned up the markdown formatting - mostly the tags on links and indented code highlighting formatting.
-
-:::
-
 ```bash
 ```bash
 david@ovid🏛 :~/sites/daw_til(main○) » npm outdated 
 david@ovid🏛 :~/sites/daw_til(main○) » npm outdated 
 Package                          Current  Wanted  Latest  Location                                      Depended by
 Package                          Current  Wanted  Latest  Location                                      Depended by
@@ -73,7 +63,42 @@ clsx                               1.2.1   1.2.1   2.0.0  node_modules/clsx
 docusaurus-lunr-search             3.0.0   3.3.0   3.3.0  node_modules/docusaurus-lunr-search           daw_til
 docusaurus-lunr-search             3.0.0   3.3.0   3.3.0  node_modules/docusaurus-lunr-search           daw_til
 react                             17.0.2  17.0.2  18.2.0  node_modules/react                            daw_til
 react                             17.0.2  17.0.2  18.2.0  node_modules/react                            daw_til
 react-dom                         17.0.2  17.0.2  18.2.0  node_modules/react-dom                        daw_til
 react-dom                         17.0.2  17.0.2  18.2.0  node_modules/react-dom                        daw_til
+```
+
+:::danger
+
+v3 now requires React 18 and Typescript 5
+
+This introduced a bunch of breaking errors in the markdown formatting via the MDX formatting that are documented at:
+- [https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3](https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3)
+- [https://github.com/facebook/docusaurus/discussions/9312](https://github.com/facebook/docusaurus/discussions/9312). 
+
+Went in and cleaned up the markdown formatting - mostly the tags on links and indented code highlighting formatting.
+
+:::
+
+The build process was also failing due to some errors defining text wrapped in `{}` 👇🏼
+
+```bash
+Error: Failed to compile due to Webpack errors.
+  Error: Docusaurus server-side rendering could not render static page with path /docs/editors/git because of error: stash_number is not defined
+
+  Error: Docusaurus server-side rendering could not render static page with path /docs/lang/Rust because of error: url is not defined
+
+  Error: Docusaurus server-side rendering could not render static page with path /docs/shell/zsh because of error: bz2 is not defined
+
+  Error: Docusaurus server-side rendering could not render static page with path /lists/tweets_follow because of error: SoftwareHardwareDeveloperDesignerMakerInventor is not defined
+      at /Users/david/Sites/daw_til/node_modules/@docusaurus/core/lib/webpack/utils.js:207:24
+      at /Users/david/Sites/daw_til/node_modules/webpack/lib/MultiCompiler.js:554:14
+      at processQueueWorker (/Users/david/Sites/daw_til/node_modules/webpack/lib/MultiCompiler.js:491:6)
+      at process.processTicksAndRejections (node:internal/process/task_queues:77:11)
+}
+
+[INFO] Docusaurus version: 3.0.0
+Node version: v18.12.1
+```
 
 
+```
 david@ovid🏛 :~/sites/daw_til(main⚡) » npm list     
 david@ovid🏛 :~/sites/daw_til(main⚡) » npm list     
 daw-til-2@0.0.1 /Users/david/Sites/daw_til
 daw-til-2@0.0.1 /Users/david/Sites/daw_til
 ├── @docusaurus/core@3.0.0
 ├── @docusaurus/core@3.0.0