Initial Site Build: Current Logic, Available Content, Open Problems, and Next Steps

· Chinese version
Last updated on

This site has reached a usable first stage. It can now stably hold content, but it is still very much an early system that will continue to evolve.

I do not want it to be a static personal card. I want it to function as a long-term working surface: a place to write about physics, teaching, programming, and photography, while also documenting the ongoing refinement of the site itself.


What Logic the Site Already Has

Several structural decisions are already in place.

1. Bilingual content is physically separated

Chinese and English content live in different directories, and the routing system also keeps them separate under [zh-Hans] and [en]. The point is not merely to claim bilingual support, but to make both language branches maintainable and structurally clear.

2. The sections already have distinct roles

At the moment, the site is organized into five main areas:

  • Blog: short updates, build notes, ongoing reflections, and ideas that have not yet become full essays.
  • Physics: writing and study notes centered on gravity, cosmology, and theoretical physics.
  • Teaching: content related to physics teaching, learning design, and IB Physics.
  • Programming: engineering notes on automation, independent software, development tooling, and system building.
  • Photography: image-based browsing, categorized galleries, and individual photo viewing.

3. The article system is already extensible

The article-based sections now support:

  • a single canonical article path,
  • tag archives,
  • category archives driven by frontmatter metadata,
  • collection-level configuration for enabling categories,
  • and configurable previous/next article logic when entering from category pages.

That means future expansion should mostly happen at the content layer, rather than requiring another structural rewrite.

4. The project already has an engineering loop

The site is no longer a one-off prototype. It already has:

  • Astro static builds,
  • a bilingual routing model,
  • content collections with schema validation,
  • a deployment-oriented build workflow,
  • and a structure that can keep growing without being rebuilt from scratch.

What Content or Services It Currently Provides

At this stage, the site mainly provides content and presentation rather than complex application-like services.

Content already available

  • Physics writing focused on first-principles thinking, conceptual structure, and theoretical perspectives.
  • Teaching material centered on IB Physics and study planning.
  • Programming articles covering Astro, GitHub Actions, Git, RustleFlow, and related engineering topics.
  • Photography content organized through category-based browsing.
  • Partial bilingual coverage across the main article sections.

What visitors can already do

  • Browse content by section.
  • Filter article content by tags and categories.
  • Move through previous and next articles inside article pages.
  • Read the site in a structurally consistent Chinese and English layout.

So, for now, this site works more like a long-form notebook, a teaching index, a development log, and a photography wall than a fully productized platform.


What Still Has Not Been Solved

Because the site is still early, some unfinished parts are already visible.

1. Content coverage is still uneven

The sections already have clear identities, but their content depth is not balanced yet. Some sections are taking shape quickly, while others are still being filled in. The blog itself was empty until now.

2. Interaction details still need polishing

Mobile behavior, visual rhythm, and local consistency have already gone through one round of fixes, but there is still room between “works” and “feels right.” Many remaining issues are not major bugs, but small points of friction.

3. English coverage is still being built out

The bilingual structure exists, but not every area is fully symmetrical yet. The practical strategy has been to finish the structure first and keep filling in the English layer over time.

4. The design is not in its final form

The pages are already usable, but the visual language, page density, and homepage hierarchy still have not reached the level of sharpness and identity that I want.


Planned Redesign Directions

The next phase will focus more on sustained writing and sustained readability than on blindly adding features.

1. Expand the blog as a real timeline

The blog will carry more build notes, project announcements, structural changes, and short reflections so it becomes an actual running record of the site’s evolution.

2. Continue filling in bilingual content

Topics that are clearly long-term parts of the site will gradually receive English counterparts, so bilingual support becomes real at the content layer, not just at the routing layer.

3. Refine the homepage and section entrances

The homepage will likely keep changing. The goal is to make the character of each section feel more distinct and reduce the sense that all the information is present but not yet sharply arranged.

4. Keep improving the article system

Categories, tags, previous/next navigation, and collection-level configuration are already in place. The next likely improvements are archive pages, list density, contextual links, and better content discovery.

5. Build a more natural bridge between photography and writing

The photography section should not remain an isolated image shelf. Over time, I want to explore stronger links between photographs, short logs, and longer themed writing.


Closing Note

If building a site is treated as an experiment, then this one has already moved past the stage of asking whether it can be built at all. It is now in the stage of learning how it should keep growing.

It already has a working structure, a usable engineering base, and enough content logic to support long-term writing. The more important work now is not to finish everything at once, but to keep writing, keep refining, and let structure and content mature together.