Skip to content

Migrate to dita-bootstrap GitHub org#306

Open
infotexture wants to merge 2 commits intodevelopfrom
feature/org-migration
Open

Migrate to dita-bootstrap GitHub org#306
infotexture wants to merge 2 commits intodevelopfrom
feature/org-migration

Conversation

@infotexture
Copy link
Copy Markdown
Collaborator

  • Rename plug-in ID net.infotexture.dita-bootstraporg.dita-bootstrap.html in plugin.xml, Ant build templates, XSL plugin: URI imports, CI workflow, README, and sample DITA files.
  • Update GitHub URLs from infotexture/dita-bootstrapdita-bootstrap/dita-bootstrap and the GitHub Pages site infotexture.github.io/dita-bootstrapdita-bootstrap.github.io.
  • Cross-references to dita-bootstrap.{lunr,sass,extension,table} updated to the new org.dita-bootstrap.* plug-in IDs and to the new GitHub org URLs.

- Rename plug-in ID `net.infotexture.dita-bootstrap` → `org.dita-bootstrap.html` in plugin.xml,
  Ant build templates, XSL `plugin:` URI imports, CI workflow, README, and sample DITA files.
- Update GitHub URLs from `infotexture/dita-bootstrap` → `dita-bootstrap/dita-bootstrap` and the
  GitHub Pages site `infotexture.github.io/dita-bootstrap` → `dita-bootstrap.github.io`.
- Cross-references to `dita-bootstrap.{lunr,sass,extension,table}` updated to the new `org.dita-bootstrap.*`
  plug-in IDs and to the new GitHub org URLs.

Signed-off-by: Roger Sheen <roger@infotexture.net>
@infotexture infotexture self-assigned this Apr 26, 2026
@infotexture infotexture requested a review from jason-fox April 26, 2026 19:16
Copy link
Copy Markdown
Collaborator

@jason-fox jason-fox left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of the links are lacking .html - I think this should fix them.

I would also add a badge similar to the dita-bootstrap.specialization one:

https://github.com/dita-bootstrap/dita-bootstrap.specialization/blob/develop/.github/dita-ot/header.xml#L37

Note that neither the dita-bootstrap.html nor dita-bootstrap.specialization websites are the primary URL anymore - that is generated from the dita-bootstrap.github.io repo, which is currently using the specialization DITA with the tabbed dialog.

It would be possible to add the tabbed dialog here too, but I'd prefer to do that after completing this migration merge.

Comment thread README.md
https://github.com/jason-fox/fox.jason.extend.css/archive/master.zip
dita --install \
https://github.com/infotexture/dita-bootstrap/archive/master.zip
https://github.com/dita-bootstrap/dita-bootstrap/archive/master.zip
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
https://github.com/dita-bootstrap/dita-bootstrap/archive/master.zip
https://github.com/dita-bootstrap/dita-bootstrap.html/archive/master.zip

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wasn't sure we wanted to rename the repo too, or just the plug-in ID, but I suppose using the same for both is least confusing.

<a
class="btn m-1"
href="https://github.com/infotexture/dita-bootstrap"
href="https://github.com/dita-bootstrap/dita-bootstrap"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
href="https://github.com/dita-bootstrap/dita-bootstrap"
href="https://github.com/dita-bootstrap/dita-bootstrap.html"

</button>
</div>
<a class="navbar-brand" href="https://infotexture.github.io/dita-bootstrap">
<a class="navbar-brand" href="https://dita-bootstrap.github.io">
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a class="navbar-brand" href="https://dita-bootstrap.github.io">
<a class="navbar-brand" href="https://dita-bootstrap.github.io/dita-bootstrap.html">

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this change is correct, since so far the main plug-in has been represented by the project's landing page, rather than a subpage.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the main plug-in has been represented by the project's landing page, rather than a subpage.

The overall organization website is the new landing page, and dita-bootstrap.github.io is no longer built using the HTML plugin's header.xml - it is a separate CI in a separate repo. dita-bootstrap.github.io/dita-bootstrap.html/index.html is just the CI build for testing:

This means that the sample files are examples either using or not using the DTD

This is why I suggest adding a badge to the header here, since https://dita-bootstrap.github.io/dita-bootstrap.html is just a subpage test website. I'd also consider altering the header background from primary to bg-light to make it even more obvious that this isn't the main website

The main landing page could easily be built from either of these sources - currently building from the specialization. The main landing-page now has dropdown menus to link to all the plugins, not just the HTML

Comment thread sample/index.dita
>--install</parmname> https://github.com/jason-fox/fox.jason.extend.css/archive/master.zip
<cmdname>dita</cmdname> <parmname
>--install</parmname> https://github.com/infotexture/dita-bootstrap/archive/master.zip</codeblock>
>--install</parmname> https://github.com/dita-bootstrap/dita-bootstrap/archive/master.zip</codeblock>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
>--install</parmname> https://github.com/dita-bootstrap/dita-bootstrap/archive/master.zip</codeblock>
>--install</parmname> https://github.com/dita-bootstrap/dita-bootstrap.html/archive/master.zip</codeblock>

Comment thread sample/dark-mode.dita
<p>The plug-in includes a sample color mode toggler in its
<xref
href="https://github.com/infotexture/dita-bootstrap/blob/develop/includes/hdr.navbar.example.xml"
href="https://github.com/dita-bootstrap/dita-bootstrap/blob/develop/includes/hdr.navbar.example.xml"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
href="https://github.com/dita-bootstrap/dita-bootstrap/blob/develop/includes/hdr.navbar.example.xml"
href="https://github.com/dita-bootstrap/dita-bootstrap.html/blob/develop/includes/hdr.navbar.example.xml"

Comment thread .github/workflows/ci.yml Outdated
fox.jason.extend.css
https://github.com/infotexture/dita-bootstrap/archive/develop.zip
net.infotexture.dita-bootstrap.lunr
https://github.com/dita-bootstrap/dita-bootstrap/archive/develop.zip
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
https://github.com/dita-bootstrap/dita-bootstrap/archive/develop.zip
https://github.com/dita-bootstrap/dita-bootstrap.html/archive/develop.zip

<a
class="nav-link"
href="https://github.com/infotexture/dita-bootstrap"
href="https://github.com/dita-bootstrap/dita-bootstrap"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
href="https://github.com/dita-bootstrap/dita-bootstrap"
href="https://github.com/dita-bootstrap/dita-bootstrap.html"

<a
class="nav-link"
href="https://github.com/infotexture/dita-bootstrap/releases"
href="https://github.com/dita-bootstrap/dita-bootstrap/releases"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
href="https://github.com/dita-bootstrap/dita-bootstrap/releases"
href="https://github.com/dita-bootstrap/dita-bootstrap.html/releases"

Comment thread package.json
"repository": {
"type": "git",
"url": "https://github.com/infotexture/dita-bootstrap.git"
"url": "https://github.com/dita-bootstrap/dita-bootstrap.git"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"url": "https://github.com/dita-bootstrap/dita-bootstrap.git"
"url": "https://github.com/dita-bootstrap/dita-bootstrap.html.git"

@jason-fox
Copy link
Copy Markdown
Collaborator

Another thing we'll need to do as part of the merge, update the README of sass, lunr, extension etc. to refer to the dita-bootstrap.html dependency

@infotexture
Copy link
Copy Markdown
Collaborator Author

Another thing we'll need to do as part of the merge, update the README[s]

That should've been part of the open PRs for those plug-ins, but if something's missing there we can push another commit to include those changes along with the others.

@infotexture
Copy link
Copy Markdown
Collaborator Author

I would also add a badge similar to the dita-bootstrap.specialization one:

Not sure the white-on-teal would pass minimum contrast ratios for accessibility, but that shouldn't be hard to adjust.

The standard gray “secondary” variant might be more suitable there.

@jason-fox
Copy link
Copy Markdown
Collaborator

jason-fox commented Apr 27, 2026

Not sure the white-on-teal would pass minimum contrast ratios

Not really an issue - CI subdomain builds are only for testing - I just want these testing sub-pages to indicating its as probably not where a user want to be.

The standard gray “secondary” variant might be more suitable there.

Why not follow the same scheme as specialization?

<nav class="navbar navbar-expand-lg navbar navbar-expand-lg bg-secondary-subtle">
...
       DITA Bootstrap
      <span class="badge bg-dark small  m-0">outputClass</span>

... etc.

Comment thread .github/dita-ot/html.xml
name="open-graph.url"
value="https://infotexture.github.io/dita-bootstrap"
/>
<param name="open-graph.url" value="https://dita-bootstrap.github.io"/>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With the recent update to the open-graph plugin, this will also set the canonical meta data to https://dita-bootstrap.github.io, which is good, it will mean search engines should start to index that URL rather than the https://dita-bootstrap.github.io/dita-bootstrap.html/ clone or the old https://infotexture.github.io/dita-bootstrap/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants