Move to the new API url structure of v2 and redirect all possible previous v2.x locations

Author: andydotxyz

_gen/genapi.sh

@@ -11,7 +11,7 @@ go install github.com/andydotxyz/godocdown/godocdown@latest
 # generate API docs
 
 DIRS=`find $ROOT -type d | grep -v .git | grep -v vendor | grep -v internal | grep -v testdata | grep -v cmd | grep -v tools`
-PREFIX="content/docs/api/$VERSION"
+PREFIX="content/docs/api/v2"
 mkdir $PREFIX 2>&1 > /dev/null
 
 godocdown -template="_gen/api.md" -outputDir "$PREFIX/" $ROOT 2>&1 | grep -v "Could not find package"
@@ -55,11 +55,21 @@ for DIR in $DIRS; do
 		PKGNAME="fyne"
 		mv $PREFIX/$OUT $PREFIX/fyne/$OUT
 	fi
+
+    declare -a vers=("v2.0" "v2.1" "v2.2" "v2.3" "v2.4" "v2.5" "v2.6" "v2.7")
+	
+    ALIASLIST=""
+    for i in "${vers[@]}"
+    do
+      ALIASLIST=$ALIASLIST"\n- \/api\/$i\/$PKGPATH"
+    done
 
-    sed -i.bak "s|slug:|slug: $NAME\n\naliases:\n- \/api\/$VERSION\/$PKGPATH|" "$PREFIX/$PKGNAME/$OUT"
-    sed -i.bak "s|# .*||" "$PREFIX/$PKGNAME/$OUT"
+    if [[ "$OUT" != '*.md' ]]; then
+      sed -i.bak "s|slug:|slug: $NAME\n\naliases:$ALIASLIST|" "$PREFIX/$PKGNAME/$OUT"
+      sed -i.bak "s|^# .*||" "$PREFIX/$PKGNAME/$OUT"
+    fi
   done
 done
 
-rm content/docs/api/$VERSION/_index.md
+rm content/docs/api/v2/_index.md
 find content/docs/api/ -name \*.bak -exec rm {} \;

content/docs/api/v2.7/app/_index.md content/docs/api/v2/app/_index.mdcontent/docs/api/v2.7/app/_index.md renamed to content/docs/api/v2/app/_index.md

@@ -4,6 +4,13 @@ title: app (package)
 slug: (package)
 
 aliases:
+- /api/v2.0/app
+- /api/v2.1/app
+- /api/v2.2/app
+- /api/v2.3/app
+- /api/v2.4/app
+- /api/v2.5/app
+- /api/v2.6/app
 - /api/v2.7/app
 
 package: fyne.io/fyne/v2/app
@@ -17,23 +24,23 @@ import "fyne.io/fyne/v2/app"
 
 Package app provides app implementations for working with Fyne graphical interfaces. The fastest way to get started is to call app.New() which will normally load a new desktop application. If the "ci" tag is passed to go (go run -tags ci myapp.go) it will run an in-memory application.
 
-#
+## Usage
 
-###
+#### func  New
 
 ```go
 func New() fyne.App
 ```
 New returns a new application instance with the default driver and no unique ID (unless specified in FyneApp.toml)
 
-###
+#### func  NewWithID
 
 ```go
 func NewWithID(id string) fyne.App
 ```
 NewWithID returns a new app instance using the appropriate runtime driver. The ID string should be globally unique to this app.
 
-###
+#### func  SetDriverDetails
 
 ```go
 func SetDriverDetails(a fyne.App, d embedded.Driver)
@@ -44,13 +51,13 @@ SetDriverDetails provides the required information to our app to run without a s
 <div class="since">Since: <code>
 2.7</code></div>
 
-###
+#### func  SetMetadata
 
 ```go
 func SetMetadata(m fyne.AppMetadata)
 ```
 SetMetadata overrides the packaged application metadata. This data can be used in many places like notifications and about screens.
 
-###
+#### types
 
  * [SettingsSchema](settingsschema.html)

content/docs/api/v2.7/app/pkg.md content/docs/api/v2/app/pkg.mdcontent/docs/api/v2.7/app/pkg.md renamed to content/docs/api/v2/app/pkg.md

@@ -4,6 +4,13 @@ title: app.SettingsSchema
 slug: settingsschema
 
 aliases:
+- /api/v2.0/app/settingsschema
+- /api/v2.1/app/settingsschema
+- /api/v2.2/app/settingsschema
+- /api/v2.3/app/settingsschema
+- /api/v2.4/app/settingsschema
+- /api/v2.5/app/settingsschema
+- /api/v2.6/app/settingsschema
 - /api/v2.7/app/settingsschema
 
 package: fyne.io/fyne/v2/app
@@ -15,9 +22,9 @@ package: fyne.io/fyne/v2/app
 import "fyne.io/fyne/v2/app"
 ```
 
-#
+## Usage
 
-###
+#### type SettingsSchema
 
 ```go
 type SettingsSchema struct {
@@ -33,7 +40,7 @@ type SettingsSchema struct {
 
 SettingsSchema is used for loading and storing global settings
 
-###
+#### func (*SettingsSchema) StoragePath
 
 ```go
 func (sc *SettingsSchema) StoragePath() string

…tent/docs/api/v2.7/app/settingsschema.md content/docs/api/v2/app/settingsschema.mdcontent/docs/api/v2.7/app/settingsschema.md renamed to content/docs/api/v2/app/settingsschema.md content/docs/api/v2.7/app/settingsschema.md renamed to content/docs/api/v2/app/settingsschema.md

@@ -4,6 +4,13 @@ title: canvas.Arc
 slug: arc
 
 aliases:
+- /api/v2.0/canvas/arc
+- /api/v2.1/canvas/arc
+- /api/v2.2/canvas/arc
+- /api/v2.3/canvas/arc
+- /api/v2.4/canvas/arc
+- /api/v2.5/canvas/arc
+- /api/v2.6/canvas/arc
 - /api/v2.7/canvas/arc
 
 package: fyne.io/fyne/v2/canvas
@@ -15,9 +22,9 @@ package: fyne.io/fyne/v2/canvas
 import "fyne.io/fyne/v2/canvas"
 ```
 
-#
+## Usage
 
-###
+#### type Arc
 
 ```go
 type Arc struct {
@@ -37,91 +44,91 @@ Arc represents a filled arc or annular sector primitive that can be drawn on a F
 <div class="since">Since: <code>
 2.7</code></div>
 
-###
+#### func  NewArc
 
 ```go
 func NewArc(startAngle, endAngle, cutoutRatio float32, color color.Color) *Arc
 ```
 NewArc returns a new Arc instance with the specified start and end angles (in degrees), fill color and cutout ratio.
 
-###
+#### func  NewDoughnutArc
 
 ```go
 func NewDoughnutArc(startAngle, endAngle float32, color color.Color) *Arc
 ```
 NewDoughnutArc returns a new doughnut-shaped Arc instance with the specified start and end angles (in degrees), fill color and cutout ratio set to 0.5.
 
-###
+#### func  NewPieArc
 
 ```go
 func NewPieArc(startAngle, endAngle float32, color color.Color) *Arc
 ```
 NewPieArc returns a new pie-shaped Arc instance with the specified start and end angles (in degrees), fill color and cutout ratio set to 0.
 
-###
+#### func (*Arc) Hide
 
 ```go
 func (a *Arc) Hide()
 ```
 Hide will set this arc to not be visible.
 
-###
+#### func (*Arc) MinSize
 
 ```go
 func (o *Arc) MinSize() fyne.Size
 ```
 MinSize returns the specified minimum size, if set, or {1, 1} otherwise.
 
-###
+#### func (*Arc) Move
 
 ```go
 func (a *Arc) Move(pos fyne.Position)
 ```
 Move the arc to a new position, relative to its parent / canvas. The position specifies the **center** of the arc.
 
-###
+#### func (*Arc) Position
 
 ```go
 func (o *Arc) Position() fyne.Position
 ```
 Position gets the current position of this canvas object, relative to its parent.
 
-###
+#### func (*Arc) Refresh
 
 ```go
 func (a *Arc) Refresh()
 ```
 Refresh causes this arc to be redrawn with its configured state.
 
-###
+#### func (*Arc) Resize
 
 ```go
 func (a *Arc) Resize(s fyne.Size)
 ```
 Resize updates the logical size of the arc. The arc is always drawn centered on its Position().
 
-###
+#### func (*Arc) SetMinSize
 
 ```go
 func (o *Arc) SetMinSize(size fyne.Size)
 ```
 SetMinSize specifies the smallest size this object should be.
 
-###
+#### func (*Arc) Show
 
 ```go
 func (o *Arc) Show()
 ```
 Show will set this object to be visible.
 
-###
+#### func (*Arc) Size
 
 ```go
 func (o *Arc) Size() fyne.Size
 ```
 Size returns the current size of this canvas object.
 
-###
+#### func (*Arc) Visible
 
 ```go
 func (o *Arc) Visible() bool

content/docs/api/v2.7/canvas/_index.md content/docs/api/v2/canvas/_index.mdcontent/docs/api/v2.7/canvas/_index.md renamed to content/docs/api/v2/canvas/_index.md

@@ -4,6 +4,13 @@ title: canvas.Circle
 slug: circle
 
 aliases:
+- /api/v2.0/canvas/circle
+- /api/v2.1/canvas/circle
+- /api/v2.2/canvas/circle
+- /api/v2.3/canvas/circle
+- /api/v2.4/canvas/circle
+- /api/v2.5/canvas/circle
+- /api/v2.6/canvas/circle
 - /api/v2.7/canvas/circle
 
 package: fyne.io/fyne/v2/canvas
@@ -15,9 +22,9 @@ package: fyne.io/fyne/v2/canvas
 import "fyne.io/fyne/v2/canvas"
 ```
 
-#
+## Usage
 
-###
+#### type Circle
 
 ```go
 type Circle struct {
@@ -33,70 +40,70 @@ type Circle struct {
 
 Circle describes a colored circle primitive in a Fyne canvas
 
-###
+#### func  NewCircle
 
 ```go
 func NewCircle(color color.Color) *Circle
 ```
 NewCircle returns a new Circle instance
 
-###
+#### func (*Circle) Hide
 
 ```go
 func (c *Circle) Hide()
 ```
 Hide will set this circle to not be visible
 
-###
+#### func (*Circle) MinSize
 
 ```go
 func (c *Circle) MinSize() fyne.Size
 ```
 MinSize for a Circle simply returns Size{1, 1} as there is no explicit content
 
-###
+#### func (*Circle) Move
 
 ```go
 func (c *Circle) Move(pos fyne.Position)
 ```
 Move the circle object to a new position, relative to its parent / canvas
 
-###
+#### func (*Circle) Position
 
 ```go
 func (c *Circle) Position() fyne.Position
 ```
 Position gets the current top-left position of this circle object, relative to its parent / canvas
 
-###
+#### func (*Circle) Refresh
 
 ```go
 func (c *Circle) Refresh()
 ```
 Refresh causes this object to be redrawn with its configured state.
 
-###
+#### func (*Circle) Resize
 
 ```go
 func (c *Circle) Resize(size fyne.Size)
 ```
 Resize sets a new bottom-right position for the circle object If it has a stroke width this will cause it to Refresh.
 
-###
+#### func (*Circle) Show
 
 ```go
 func (c *Circle) Show()
 ```
 Show will set this circle to be visible
 
-###
+#### func (*Circle) Size
 
 ```go
 func (c *Circle) Size() fyne.Size
 ```
 Size returns the current size of bounding box for this circle object
 
-###
+#### func (*Circle) Visible
 
 ```go
 func (c *Circle) Visible() bool