Browse Source

update 2.4.3 👉🏼 3.0.0 and React 17.0.2 👉🏼 18.2.0

windhamdavid 6 months 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
+
 * [https://git-scm.com/](https://git-scm.com/)
 
 ### Notes:
@@ -202,9 +203,10 @@ $ git stash apply
 ```
 
 #### Restore particular stash back to current branch:
+```shell
 - *{stash_number}* can be obtained from `git stash list`
 
-```shell
+
 $ 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/)
 
 
-```
 #### notes ####
-
-```
 ---
 
 
@@ -925,10 +922,10 @@ Custom errors & types in Response
     }
 ```
 Configure Rocket.toml
-
+```
     [global.databases]
     doodlebase = {url = "postgres://acct:pw@localhost/dbname"}
-
+```
 ### Sessions
 ```
     //in session.rs
@@ -976,7 +973,7 @@ Configure Rocket.toml
     )
 ```
 ## CLI
-
+```
 **Crate**: clap
 
     use clap::{clap_app, crate_version};
@@ -1002,3 +999,4 @@ Configure Rocket.toml
     				// access value:
     	      sub.value_of("field_1").unwrap()
     }
+```

+ 16 - 15
docs/server/htop.md

@@ -1,15 +1,15 @@
 
 
 #### **NAME**
-
+```
        htop - interactive process viewer
-
+```
 #### **SYNOPSIS**
-
+```
        **htop** **\[**\-dChusv\]
-
+```
 #### **DESCRIPTION**
-
+```
        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
@@ -18,9 +18,9 @@
        once.
 
        Tasks related to processes (killing, renicing) can be done without entering their PIDs.
-
+```
 #### **COMMAND-LINE** **OPTIONS**
-
+```
        Mandatory arguments to long options are mandatory for short options too.
 
        **\-d** **\--delay=DELAY**
@@ -43,9 +43,9 @@
 
        **\-v** **\--version**
               Output version information and exit
-
+```
 #### **INTERACTIVE** **COMMANDS**
-
+```
        The following commands are supported while in htop:
 
        **Up,** **Alt-k**
@@ -168,9 +168,9 @@
 
        **Numbers**
             PID search: type in process ID and the selection highlight will be moved to it.
-
+```
 #### **COLUMNS**
-
+```
        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.
        The  names below are the ones used in the "Available Columns" section of the setup screen.
@@ -351,9 +351,9 @@
 
        **All** **other** **flags**
             Currently unsupported (always displays '-').
-
+```
 #### **CONFIG** **FILE**
-
+```
        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
        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
        variable (so you can have multiple configurations for different machines  that  share  the
        same home directory, for example).
-
+```
 #### **MEMORY** **SIZES**
-
+```
        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.
        (e.g., 1023M = 1072693248 Bytes)
 
        The  decision  to  use this convention was made in order to conserve screen space and make
        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 
 ---
-
+```
 -Reset  
 Color_Off='\033[0m' -Text Reset  
   
@@ -507,4 +507,5 @@ On_White='\033[47m' -White
 -Example of usage  
 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}"   
-  
+
+```

+ 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")
 ##  Commands
 
+```
+
 | Command               | Description                                                                                                                  |  
 | --------------------- | ---------------------------------------------------------------------------------------------------------------------------- |  
 | _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                                                                                                           |  
 
 * * *
+```
 
 | 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|
 |@jmvidal|Jose M Vidal|Professor Computer Science and Engineering U. of South Carolina.|
 |@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|
 |@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.|
@@ -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|
 |@jmvidal|Jose M Vidal|Professor Computer Science and Engineering U. of South Carolina.|
 |@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|
 |@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.|

+ 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
 
-:::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
 david@ovid🏛 :~/sites/daw_til(main○) » npm outdated 
 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
 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
+```
+
+:::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     
 daw-til-2@0.0.1 /Users/david/Sites/daw_til
 ├── @docusaurus/core@3.0.0