What version of AtoM are you using? And, are you developing a Bootstrap 2 theme, or attempting to develop a newer Bootstrap 5 theme?
Here are a few more resources that might help. First, we also have instructions in slide form, here:
These slides are also a bit older (so they are definitely only applicable for older Bootstrap 2 themes, not the newer BS5 templates we have begun introducing in release 2.7) and therefore I can't confirm they are totally up to date, but may still be more explicit in their steps than the docs. They link to an example theme available here:
I noticed in slide 9 the mention of creating a MakeFile
that I don't see in the documentation? This may just be a step of convenience that one of our team added to their tutorial that the other didn't include, but still, worth checking out.
Additionally, I am attaching a PDF that we deliver to clients when we create a new custom theme for them, but do not host them. It explains both how to install a plugin, as well as how AtoM theme plugins are typically structured, which again may hopefully help you sort out what's missing. Again, this is geared towards BS2 themes.
Using these various sources as references, let's see if we can figure out what's different or missing:
- Does the basic directory structure of your theme plugin match what is included in the attached PDF?
- Have you added your theme to the plugins directory of your AtoM installation?
- Did you create the configuration class PHP file, put it in the config directory of your theme plugin?
- Did you add that MakeFile mentioned above?
- Did you create a main.less file in the css directory of your theme?
- Does your main.less file include all the @imports needed from Bootstrap and the base Dominion theme, per this example? (Your custom CSS rules should go in that file as well)
- Did you install lessc and the other dependencies required to compile themes?
On this last point: these instructions are ONLY included in the Option 2 of our installation instructions (install from our GitHub repository), since we pre-compile the Dominion theme in the downloadable tarball used in Option 1.
sudo apt install npm make
sudo npm install -g "less@<4.0.0" n
sudo n stable
sudo npm install
sudo npm run build
Now we need to actually compile the theme - I am guessing that this might be the missing step... The command below is to compile the base Dominion theme. Run that, and then for your custom theme, repeat the command but use the path/name of your theme plugin instead to compile it:
sudo make -C /usr/share/nginx/atom/plugins/arDominionPlugin
And finally, if you did everything listed above but still no changes are showing, did you try...
Hope this helps!
he / him