From de0b6dd5ec5998c6839ed99ae329052d5de62516 Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 12:44:35 -0400 Subject: [PATCH 1/8] adding YML for main page. --- _config.yml | 2 ++ 1 file changed, 2 insertions(+) create mode 100644 _config.yml diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..85b5189 --- /dev/null +++ b/_config.yml @@ -0,0 +1,2 @@ +theme: jekyll-theme-hacker +markdown: kramdown From f89938e17be6289ff1c59555652cb4560480a3b1 Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 12:51:36 -0400 Subject: [PATCH 2/8] Adding more info on links. --- docs/README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/README.md b/docs/README.md index 469fd47..74736f2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -29,15 +29,17 @@ Absolute: [Syntax Basics](https://github.com/spacecataz/python_syntax/blob/main/primer01_basics.md) Relative: +links to ../primer01_basics.md [Syntax Basics](../primer01_basics.md) Using `/` as repository root: +links to /primer01_basics.md [Syntax Basics](/primer01_basics.md) ## Trying links with a file inside `/docs/`: -Absolute: +Absolute currently links to `the-whole-url/docs/example.md`: [Syntax Basics](https://github.com/spacecataz/python_syntax/blob/main/docs/example.md) -Relative: +Relative (currently links to `./docs/example.md`): [Syntax Basics](example.md) From 844c58539c405494c7395d6809c48a98cc69d99f Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 12:54:52 -0400 Subject: [PATCH 3/8] Moving things around... --- {docs => source}/example.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {docs => source}/example.md (100%) diff --git a/docs/example.md b/source/example.md similarity index 100% rename from docs/example.md rename to source/example.md From 44f24a769158b81690f0b63a67bf67cf75e09e80 Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 13:04:21 -0400 Subject: [PATCH 4/8] Implmenting new links... --- docs/README.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/README.md b/docs/README.md index 74736f2..68c7be2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -38,8 +38,11 @@ links to /primer01_basics.md ## Trying links with a file inside `/docs/`: -Absolute currently links to `the-whole-url/docs/example.md`: -[Syntax Basics](https://github.com/spacecataz/python_syntax/blob/main/docs/example.md) +Absolute currently links to `the-whole-url/source/example.md`: +[Syntax Basics](https://github.com/spacecataz/python_syntax/blob/main/source/example.md) -Relative (currently links to `./docs/example.md`): -[Syntax Basics](example.md) +Relative (currently links to `source/example.md`): +[Syntax Basics](source/example.md) + +Relative-up (currently links to `../source/example.md`): +[Syntax Basics](../source/example.md) \ No newline at end of file From 2186c40dd7bc86d9bd1657dc30f5d39706d5f6e9 Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 13:49:24 -0400 Subject: [PATCH 5/8] trying absolute link --- docs/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/README.md b/docs/README.md index 68c7be2..3d6e23a 100644 --- a/docs/README.md +++ b/docs/README.md @@ -41,8 +41,8 @@ links to /primer01_basics.md Absolute currently links to `the-whole-url/source/example.md`: [Syntax Basics](https://github.com/spacecataz/python_syntax/blob/main/source/example.md) -Relative (currently links to `source/example.md`): -[Syntax Basics](source/example.md) +Site-absolute. (currently links to `/source/example.md`): +[Syntax Basics](/source/example.md) Relative-up (currently links to `../source/example.md`): [Syntax Basics](../source/example.md) \ No newline at end of file From 8f465942ffe05e95547b34d18af2c615fc2421aa Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 14:14:00 -0400 Subject: [PATCH 6/8] trying more link bullshit. --- docs/README.md | 13 +++++++++++-- docs/test.md | 2 ++ 2 files changed, 13 insertions(+), 2 deletions(-) create mode 100644 docs/test.md diff --git a/docs/README.md b/docs/README.md index 3d6e23a..99bd7ea 100644 --- a/docs/README.md +++ b/docs/README.md @@ -42,7 +42,16 @@ Absolute currently links to `the-whole-url/source/example.md`: [Syntax Basics](https://github.com/spacecataz/python_syntax/blob/main/source/example.md) Site-absolute. (currently links to `/source/example.md`): -[Syntax Basics](/source/example.md) +[Syntax Basics](./source/example.md) +[Syntax Basics](python_syntax/source/example.md) +[Syntax Basics](/python_syntax/source/example.md) +[Syntax Basics](python_syntax/blob/website/source/example.md) +[Syntax Basics](python_syntax/blob/website/source/example.md) Relative-up (currently links to `../source/example.md`): -[Syntax Basics](../source/example.md) \ No newline at end of file +[Syntax Basics](../source/example.md) + +### Internal to `Docs` links: +[test page](test.md) +[test page](./docs/test.md) +[test page](docs/test.md) \ No newline at end of file diff --git a/docs/test.md b/docs/test.md new file mode 100644 index 0000000..b69b581 --- /dev/null +++ b/docs/test.md @@ -0,0 +1,2 @@ +# Another page. +another page. \ No newline at end of file From 7a3e4166bc6547878cbf6b593dc4ef3e4e123da9 Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 14:23:06 -0400 Subject: [PATCH 7/8] trying links at top level. --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7844141..f553731 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,22 @@ users learn the language. | 5 | OOP: Embracing object-oriented programming in Python | | 6 | Strings: The gory details of strings and formatting. | +## omg the link stuff. +Site-absolute. (currently links to `/source/example.md`): +[Syntax Basics](./source/example.md) +[Syntax Basics](python_syntax/source/example.md) +[Syntax Basics](/python_syntax/source/example.md) +[Syntax Basics](python_syntax/blob/website/source/example.md) +[Syntax Basics](python_syntax/blob/website/source/example.md) + +Relative-up (currently links to `../source/example.md`): +[Syntax Basics](../source/example.md) + +### Internal to `Docs` links: +[test page](test.md) +[test page](./docs/test.md) +[test page](docs/test.md) + ## Using These Tutorials All files are markdown-formatted Jupyter notebooks. @@ -44,7 +60,7 @@ on your machine. [Information on installing and using Jupytext can be found here.](https://jupytext.readthedocs.io/en/latest/index.html) Finally, Jupyter-nbconvert is required for generation of HTML or PDF versions -of the tutorials. +of the tutorials. Typical installation on a Debian-like machine will look like this: From b466abdc17146d709c6278a3b32b3cdbff2a76eb Mon Sep 17 00:00:00 2001 From: Dan Welling Date: Fri, 23 May 2025 14:27:04 -0400 Subject: [PATCH 8/8] I think i got it. --- README.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index f553731..f10401a 100644 --- a/README.md +++ b/README.md @@ -14,11 +14,13 @@ users learn the language. | 6 | Strings: The gory details of strings and formatting. | ## omg the link stuff. -Site-absolute. (currently links to `/source/example.md`): -[Syntax Basics](./source/example.md) -[Syntax Basics](python_syntax/source/example.md) -[Syntax Basics](/python_syntax/source/example.md) -[Syntax Basics](python_syntax/blob/website/source/example.md) +Site-absolute. (currently links to `source/example.md`): +[Syntax Basics](source/example.md) +[Primer 1](./primer01_basics.md) +[Primer 2](./primer02_suites.md) +[Primer 3](./primer03_fileIO.md) +[Primer 3](./primer04_modules.md) + [Syntax Basics](python_syntax/blob/website/source/example.md) Relative-up (currently links to `../source/example.md`):