Merge pull request #21787 from AnnsAnns/starlight_fix_for_the_fix

doc/starlight: Add temporary workaround to symlink issue

Author: AnnsAnns

doc/starlight/.gitignore

@@ -12,10 +12,12 @@ yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
 
-
 # environment variables
 .env
 .env.production
 
 # macOS-specific files
 .DS_Store
+
+# Don't show copied files
+src/content/docs/**

doc/starlight/Makefile

@@ -10,11 +10,22 @@ install: integrate_outside_files
 
 .PHONY: build
 build: install
+	@echo "Copying RIOT documentation source files..."
+	@echo "See: https://github.com/withastro/starlight/issues/3470"
+	@rm -rf $(CURDIR)/src/content/docs
+	@cp -r $(RIOTBASE)/doc/guides $(CURDIR)/src/content/docs
 	@npm run build --prefix $(CURDIR)
 	@echo "RIOT documentation successfully generated at file://$(RIOTBASE)/doc/starlight/dist/index.html"
 
+.PHONY: preview
+preview: build
+	@npm run preview --prefix $(CURDIR)
+
 .PHONY: dev
 dev: install
+	@echo "Linking RIOT documentation source files..."
+	@rm -rf $(CURDIR)/src/content/docs
+	@ln -s ../../../guides $(CURDIR)/src/content/docs
 	@echo "Starting starlight live server..."
 	@npm run dev --prefix $(CURDIR)