alamb commented on code in PR #44:
URL: https://github.com/apache/datafusion-site/pull/44#discussion_r1874404718
##########
pelicanconf.py:
##########
@@ -37,9 +37,10 @@
ARCHIVES_SAVE_AS = ''
# Disable articles by pointing to a (should-be-absent) subdir
ARTICLE_PATHS = [ 'blog' ]
-# needed to create blogs page
-ARTICLE_URL = 'blog/{date:%Y}/{date:%m}/{date:%d}/{filename}'
-ARTICLE_SAVE_AS = 'blog/{date:%Y}/{date:%m}/{date:%d}/{filename}/index.html'
+# needed to create blogs page. Do not put the preceeding /blog here because
+# that will be added by asf infra when it posts the site
Review Comment:
Maybe it is also worth noting here we use this url scheme to preserve old
links
```suggestion
# (Use this particular URL scheme to maintain link compatibility with older
versions of this site)
##########
README.md:
##########
@@ -2,8 +2,27 @@
This repository contains the Apache DataFusion blog at
https://datafusion.apache.org/blog/
+## Testing
+
+There are two ways to preview your blog post before publishing the site. You
can
+either locally build and test the site or you can use the auto staging feature
+of the CI system. To locally build the site on your machine, follow the docker
+instructions below.
+
+To use the staging feature of the CI system, push a branch that starts with
+`site/` and create a PR to merge this branch into `main`. When you do so, it
+will trigger a CI process that will build the site and push it to the branch
+`asf-staging`. Once this completes, the ASF infrastructure will auto publish
+this staged branch to https://datafusion.staged.apache.org/
+
+The most recently run staging CI pipeline will be published to this site. If
you
Review Comment:
I tested it out and I think this workflow doesn't work for forks -- see
review comments
```suggestion
This workflow only works for branches in this repository (not for forks).
In order to use https://datafusion.staged.apache.org/ you need to be a
committer
and create the branch directly in this repository.
The most recently run staging CI pipeline will be published to this site. If
you
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org
For additional commands, e-mail: github-h...@datafusion.apache.org
