docusaurus blog #266

Merged
techknowlogick merged 36 commits from HesterG/blog:docusaurus-blog into main 2023-07-12 03:25:23 +00:00
Member

Notes

  • date must not have double quotes, e.g., should be like date: 2022-10-30T18:25:00+09:15

  • Updated header.

    Screen Shot 2023-07-11 at 17.27.49

  • Used customized blog plugin to get all tags with reference to plugins/blog/index.js. Filter by tag section, tag list page.

    Screen Shot 2023-07-11 at 18.10.28

    Screen Shot 2023-07-11 at 17.31.20

  • Added coverImage to frontmatter to assgin cover image, e.g., coverImage: "/img/blog-covers/test.jpeg"
    And on blog page, cover image will appear on top if coverImage added to frontmatter, e.g.,

    Screen Shot 2023-07-11 at 17.33.09

    Screen Shot 2023-07-11 at 17.33.20

  • authors are managed by the authors.yml file. reference

  • ejected @docusaurus/theme-classic BlogListPage and @docusaurus/theme-classic BlogPostPage, which are marked as unsafe by docusaurus, so need to maintain these components. (original BlogListPage, original BlogPostPage)

  • referenced repo

How to test

npm i
npm run start

Build and serve

npm run build
npm run serve

Help Needed

Deploy and preview steps

More Screenshots

Screen Shot 2023-07-11 at 17.34.54

Mobile:

Screen Shot 2023-07-11 at 18.16.54

Screen Shot 2023-07-10 at 17.53.18

Screen Shot 2023-07-06 at 11.02.21

Screen Shot 2023-07-11 at 18.17.43

Screen Shot 2023-07-03 at 15.32.45

TODO

  • Add Banner to blog page
# Notes - date must not have double quotes, e.g., should be like `date: 2022-10-30T18:25:00+09:15` - Updated header. ![Screen Shot 2023-07-11 at 17.27.49](/attachments/d14b0c62-3630-47a9-bcda-25c6459d4e8b) - Used customized blog plugin to get all tags with reference to [plugins/blog/index.js](https://github.com/questdb/questdb.io/blob/master/plugins/blog/index.js). Filter by tag section, tag list page. ![Screen Shot 2023-07-11 at 18.10.28](/attachments/59561940-a2f7-4ab5-b99a-1d5b84fdbcad) ![Screen Shot 2023-07-11 at 17.31.20](/attachments/d6d82976-12c0-4c0f-acfe-218e30c7c627) - Added coverImage to frontmatter to assgin cover image, e.g., `coverImage: "/img/blog-covers/test.jpeg"` And on blog page, cover image will appear on top if `coverImage` added to frontmatter, e.g., ![Screen Shot 2023-07-11 at 17.33.09](/attachments/c27e7971-11db-4241-bc53-9e43df235fbc) ![Screen Shot 2023-07-11 at 17.33.20](/attachments/552dd9cf-fc55-4547-8014-864aeb0e5050) - authors are managed by the `authors.yml` file. [reference](https://docusaurus.io/docs/blog#global-authors) - [ejected](https://docusaurus.io/docs/swizzling#ejecting) `@docusaurus/theme-classic BlogListPage` and `@docusaurus/theme-classic BlogPostPage`, which are marked as `unsafe` by docusaurus, so need to maintain these components. ([original BlogListPage](https://github.com/facebook/docusaurus/blob/main/packages/docusaurus-theme-classic/src/theme/BlogListPage/index.tsx), [original BlogPostPage](https://github.com/facebook/docusaurus/blob/main/packages/docusaurus-theme-classic/src/theme/BlogPostPage/index.tsx)) - [referenced repo](https://github.com/questdb/questdb.io) # How to test ``` npm i npm run start ``` # Build and serve ``` npm run build npm run serve ``` # Help Needed Deploy and preview steps # More Screenshots ![Screen Shot 2023-07-11 at 17.34.54](/attachments/ee9d46ac-72ac-49de-90df-38e2afc6db02) Mobile: ![Screen Shot 2023-07-11 at 18.16.54](/attachments/8f1471a3-27cc-459a-a2ce-c0e5bdf604d3) ![Screen Shot 2023-07-10 at 17.53.18](/attachments/992d9f24-e130-41a9-8b55-86744539524c) ![Screen Shot 2023-07-06 at 11.02.21](/attachments/af1632b8-6a61-47f7-b15d-4a6080bebadb) ![Screen Shot 2023-07-11 at 18.17.43](/attachments/af0df617-27a4-46f9-a8a3-037be268e1cd) ![Screen Shot 2023-07-03 at 15.32.45](/attachments/ad2c1217-e82d-434c-81c8-5d4058e18591) # TODO - [x] Add Banner to blog page
HesterG added 1 commit 2023-07-03 01:28:39 +00:00
docusaurus
Some checks failed
check-and-test / check-and-test (pull_request) Failing after 1m24s
6fe277a6cc
HesterG added 1 commit 2023-07-03 01:45:43 +00:00
update makefile
Some checks failed
check-and-test / check-and-test (pull_request) Failing after 24s
1ee3df4f2e
HesterG added 1 commit 2023-07-03 02:49:01 +00:00
update
Some checks failed
check-and-test / check-and-test (pull_request) Failing after 28s
dadc301975
HesterG added 1 commit 2023-07-03 02:52:24 +00:00
install
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m38s
49bd2b6f49
HesterG added 1 commit 2023-07-03 02:53:42 +00:00
ci
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m34s
3764603be3
HesterG added 1 commit 2023-07-03 03:28:09 +00:00
update authors and header
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m34s
ca43ba50ff
HesterG added 1 commit 2023-07-03 03:30:30 +00:00
remove setup go
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m17s
cae1a6dbc7
lunny reviewed 2023-07-03 03:37:58 +00:00
@ -0,0 +9,4 @@
title: 'Gitea Blogs',
tagline: 'Git with a cup of tea',
favicon: 'img/favicon.png',
url: 'https://blog.gitea.io',
Owner

blog.gitea.com

blog.gitea.com
HesterG marked this conversation as resolved
lunny reviewed 2023-07-03 03:38:55 +00:00
@ -0,0 +29,4 @@
showReadingTime: true,
routeBasePath: '/',
editUrl:
'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
Owner

?

?
HesterG marked this conversation as resolved
HesterG added 1 commit 2023-07-03 03:45:47 +00:00
editurl and remove test image
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m16s
463c465f28
HesterG added 1 commit 2023-07-03 04:18:24 +00:00
update tags page
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 3m24s
efa928aa66
HesterG added 1 commit 2023-07-03 04:23:35 +00:00
remove log
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 3m6s
f25e678d01
HesterG added 1 commit 2023-07-03 06:12:31 +00:00
update
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m18s
93150ae76b
HesterG added 1 commit 2023-07-03 06:15:33 +00:00
update build dir
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m16s
10c5929765
HesterG added 1 commit 2023-07-03 06:21:57 +00:00
update icon for blog
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m18s
84438d6685
HesterG added 1 commit 2023-07-03 06:23:51 +00:00
code
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m18s
213fb0cf01
HesterG added 1 commit 2023-07-03 06:37:22 +00:00
modify toc
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m14s
391d655dba
HesterG added 1 commit 2023-07-03 07:10:17 +00:00
adjust styles
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
943b7438e9
HesterG added 1 commit 2023-07-03 07:17:02 +00:00
modify css
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m16s
1579857f75
Author
Member

Updates:

  • updated authors.yml based on maintainers
  • tags list page (See screenshot 5).
  • toc only shows h2 titles.
  • some css adjustments. Screenshots updated.
Updates: - updated `authors.yml` based on [maintainers](https://github.com/orgs/go-gitea/people) - tags list page (See screenshot 5). - toc only shows `h2` titles. - some css adjustments. Screenshots updated.
HesterG added 1 commit 2023-07-03 07:49:09 +00:00
unify breakpoints
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
544c6fd493
delvh reviewed 2023-07-03 09:21:29 +00:00
@ -0,0 +49,4 @@
Gusted:
name: Gusted
url: https://github.com/Gusted
image_url: https://github.com/Gusted.png
Owner

title: Former Gitea maintainer
url: https://gusted.xyz/
image_url: https://git.gusted.xyz/avatars/f069668bb7706c629bed11e2ae8b392c

`title: Former Gitea maintainer` `url: https://gusted.xyz/` `image_url: https://git.gusted.xyz/avatars/f069668bb7706c629bed11e2ae8b392c`
Owner

He has left the maintainer team. So the title is not suitable for now.

He has left the maintainer team. So the title is not suitable for now.
Author
Member

url and image_url updated

`url` and `image_url` updated
HesterG marked this conversation as resolved
@ -0,0 +170,4 @@
name: strk
title: Gitea maintainer
url: https://github.com/strk
image_url: https://github.com/strk.png
Owner

We should think of a strategy what to do for the people that are no (longer) Gitea maintainers.
Should we simply display nothing like at the moment, or rather something like I described for Gusted?

We should think of a strategy what to do for the people that are no (longer) Gitea maintainers. Should we simply display nothing like at the moment, or rather something like I described for Gusted?
Author
Member

Looks like he is on the maintainers' list, maybe also need to update the maintainer file?

Looks like he is on the [maintainers' list](https://github.com/orgs/go-gitea/people?query=strk), maybe also need to update the maintainer file?
Owner

I all non-maintianer users who posted blog. Just display their name and avatar, I think it's OK. Any better idea? For strk, he's still in maintainer team.

I all non-maintianer users who posted blog. Just display their name and avatar, I think it's OK. Any better idea? For strk, he's still in maintainer team.
@ -77,2 +76,3 @@
Gitea now supports `authors:`, `committer:`, `after:`, and `before:` search operators.
Example: `author:alice author:bob`
Example: `authors:alice authors:bob`
Owner

Erm… Looks like your regex caught false positives…

Erm… Looks like your regex caught false positives…
Author
Member

Thanks, fixed that in 5cfc82aa56

Thanks, fixed that in https://gitea.com/gitea/blog/commit/5cfc82aa56120003c3c3c5bd7e89277db698c8ef
HesterG marked this conversation as resolved
Owner

Oh, I think we can also add @yardenshoham to the authors.yml already. He'll appear soon too 😉

Oh, I think we can also add @yardenshoham to the `authors.yml` already. He'll appear soon too 😉
Author
Member

Oh, I think we can also add @yardenshoham to the authors.yml already. He'll appear soon too 😉

I think yardenshoham is already in it. At line 60

> Oh, I think we can also add @yardenshoham to the `authors.yml` already. He'll appear soon too 😉 I think yardenshoham is already in it. At line 60
HesterG added 1 commit 2023-07-03 09:55:07 +00:00
remove sidebar and fix false positive
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
5cfc82aa56
6543 reviewed 2023-07-03 18:17:12 +00:00
@ -0,0 +40,4 @@
url: https://github.com/jolheiser
image_url: https://github.com/jolheiser.png
noerw:
Owner

could not find me :o

could not find me :o
Author
Member

Check line 111.

Check line 111.
lunny marked this conversation as resolved
HesterG added 1 commit 2023-07-04 05:27:44 +00:00
support figure inside blog
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m16s
b79f33ca26
HesterG added 1 commit 2023-07-04 05:31:14 +00:00
remove
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m13s
d757b50ef2
Author
Member

Update: Blog Page shows banner figure of url set by coverImage inside frontmatter. If coverImage not set, the figure won't show. (See updated screenshots in description)

Update: Blog Page shows banner `figure` of url set by `coverImage` inside `frontmatter`. If `coverImage` not set, the `figure` won't show. (See updated screenshots in description)
HesterG added 1 commit 2023-07-04 05:43:38 +00:00
comment
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m11s
6c8619b7b0
HesterG added 1 commit 2023-07-04 05:47:36 +00:00
shadow
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m11s
a86d08b353
HesterG added 1 commit 2023-07-04 08:16:36 +00:00
sort authors alphabetically
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
043b4bdb99
HesterG added 1 commit 2023-07-05 00:54:00 +00:00
point to gitea.com
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m11s
46b9de135c
Author
Member

Updated author to match with the former logic:

former logic reference: 809d55ee6a

Except for the author specifically used github in the former version.

Updated author to match with the former logic: former logic reference: https://gitea.com/gitea/blog/commit/809d55ee6a2d2b0246f1878710f6266f8d89b773 Except for the author specifically used github in the former version.
HesterG added 1 commit 2023-07-06 00:56:05 +00:00
Merge branch 'main' into docusaurus-blog
Some checks failed
check-and-test / check-and-test (pull_request) Failing after 51s
12b6e7fbfd
HesterG added 1 commit 2023-07-06 00:57:47 +00:00
modify date and author
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m15s
714ad10fea
HesterG added 1 commit 2023-07-06 02:45:17 +00:00
add popular tags
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m14s
9e0cee41fe
HesterG added 1 commit 2023-07-06 02:48:47 +00:00
comments
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m13s
a00ce74977
HesterG added 1 commit 2023-07-06 03:05:40 +00:00
modify css
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m14s
4021a4b6d5
HesterG added 1 commit 2023-07-06 03:10:57 +00:00
remove
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
54b02e9513
HesterG added 1 commit 2023-07-10 09:48:16 +00:00
save change for tags
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m13s
6e1d4615e5
HesterG added 1 commit 2023-07-11 08:08:49 +00:00
use customized blog plugin
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m13s
7ac27f1df7
Author
Member

Update: Used customized blog plugin to get all tags with reference to plugins/blog/index.js

Update: Used customized blog plugin to get all tags with reference to [plugins/blog/index.js](https://github.com/questdb/questdb.io/blob/master/plugins/blog/index.js)
HesterG added 1 commit 2023-07-11 08:22:38 +00:00
remove
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m10s
bcc739982e
HesterG added 1 commit 2023-07-11 08:33:23 +00:00
update header items positions
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
2381d5fe25
HesterG added 1 commit 2023-07-11 10:11:47 +00:00
update styles and tag page
All checks were successful
check-and-test / check-and-test (pull_request) Successful in 2m12s
delete closed PR preview s3 / delete_preview (pull_request) Successful in 24s
5df3506783
Author
Member

Updated screenshots for updated header and filter tag list page

Updated screenshots for updated header and filter tag list page
Owner

What exactly is missing until this PR is ready for review?

What exactly is missing until this PR is ready for review?
Author
Member

What exactly is missing until this PR is ready for review?

I think the contents are ready now, just not very sure if deploy will be successful. (Should be successful theoretically)

> What exactly is missing until this PR is ready for review? I think the contents are ready now, just not very sure if deploy will be successful. (Should be successful theoretically)
HesterG changed title from WIP: docusaurus blog to docusaurus blog 2023-07-12 00:46:49 +00:00
lunny approved these changes 2023-07-12 01:32:02 +00:00
denyskon approved these changes 2023-07-12 03:03:36 +00:00
denyskon left a comment
Member

Awesome work!

(P. S.: Any chance to have me added to authors? :)

Awesome work! (P. S.: Any chance to have me added to authors? :)
Author
Member

Awesome work!

(P. S.: Any chance to have me added to authors? :)

Sure, but you might need to post a blog first for your name card to be seen on the blog page.

> Awesome work! > > (P. S.: Any chance to have me added to authors? :) Sure, but you might need to post a blog first for your name card to be seen on the blog page.
Member

Awesome work!

(P. S.: Any chance to have me added to authors? :)

Sure, but you might need to post a blog first for your name card to be seen on the blog page.

Thanks! I will be a co-author of the 1.20 release blog post

> > Awesome work! > > > > (P. S.: Any chance to have me added to authors? :) > > Sure, but you might need to post a blog first for your name card to be seen on the blog page. Thanks! I will be a co-author of the 1.20 release blog post
techknowlogick merged commit dab0be78b2 into main 2023-07-12 03:25:23 +00:00
HesterG deleted branch docusaurus-blog 2023-07-12 03:51:06 +00:00
Sign in to join this conversation.
No description provided.