aplos
Version:
A sleek, contemporary, and purposefully designed VitePress theme
467 lines (247 loc) • 11.9 kB
Markdown
## 2.5.0 (2024-07-21)

### Feature(s)
- Add Banners for articles
- Partial rewrite the navigation island
- New way of centering it
- Make it allow more items without overflowing
- Reorganize styles and remove unnecessary ones
- Add `start` and `end` attributes for images
- Redesign `ins` and `del` elements
### Fix(es)
- Remove SASS deprecation warnings
- Support for `progress` elements style on webkit browsers
### Cleanup(s)
- Add margins to tables and blockquotes
- Make the blockquotes less rounded
- Make Hashtags to be simply tags (no `#`)
- Add `alt` attribute to icons links
- Make informal cards use all the available space on mobile
- Remove the line from the helpful layout if used on articles
- Small style changes to the article navigation
- Make the border left for blockquotes to be `inline-start` (for better RTL support)
- Sort CSS
### Dependencies
- Bump vue from 3.4.31 to 3.4.32 (https://github.com/aplosdev/aplos/pull/33)
- Bump sass from 1.77.6 to 1.77.8 (https://github.com/aplosdev/aplos/pull/32)
### Documentation
- Rewrite the demo page
## 2.4.0 (2024-07-06)

### Features
- Support for multiple authors
- Including in the article list
- Make blog descriptions optional
- Allow a custom title for the navigation
- Make navigation links' URL be provided with `url` not `link` (fallback provided)
- Allow user to customize the date locale (default is `en-US`, rather then `en-GB` as before)
### Cleanup(s)
- Modernize the Article List type logic
- Better support for articles without tags, an author, or a date
- Hide language detection for code snippets inside informal cards
### Fix(es)
- Code Blocks disappearing on hover
- Fix dark mode for all the types of articles in the Article List component
## 2.3.1 (2024-07-01)
Small dependency updates that were missed in the last release.
### Dependencies
- Bump globals from 15.6.0 to 15.7.0 (https://github.com/aplosdev/aplos/pull/26)
- Bump @eslint/js from 9.5.0 to 9.6.0 (https://github.com/aplosdev/aplos/pull/25)
## 2.3.0 (2024-07-01)

### Feature(s)
- Add support for a full width image via the URL (with `#` + `full`)
- Add multuple types of articles
- Featured
- Draft
- Archived
- And the normal one
- Add last updated to articles
- Add styles for `var` and `tfoot` elements
### Cleanup(s)
- New deafult color accent
- Better styles for normal links in the footer
- Make Informal Cards' links use the accent color of the card
- Remove uses mixins that aren't needed and other small changes
- Remove dots from the footer copyright text and Powered by text
## 2.2.0 (2024-06-22)

### Feature(s)
- Add screenshot support for images via the URL (if the image's URL has an "screenshot" in it, it will be displayed as a screenshot)
- Add footer links
- And icorporate the "Source Code" and "Made by" links into the footer links
- Add styles for check boxes
- Add `markdown-it` plugins support for better markdown parsing
- Add support for custom copyright text
- Bring the helpful layout to the Article's Footer
### Cleanup(s)
- Slighly darker background color for dark mode
- Make a more destinctive style for descriptions in the article's header
- Other minor changes to elements
## 2.1.0 (2024-06-15)
### Feature(s)
- More improvements to the `kbd` element
- Restyle the `kbd` element
- Make images pixelated via the URL (with `#` + `pixel`)
- Make the RSS feed link the navigation to download the file linked to the link
- Configurable message
- After each article
- After the footer
- Better styling for `ins` and `del` elements
- Styling for `code` tags inside headings
- Add a `style` frontmatter configuration for the `article` layout
### Cleanup(s)
- Project rebranding
- New accent color
- New icon
- Remove link decoration to the articles' footer
- Make the Content Width smaller by default
- Warp text pretty
- Restyle informal cards
- Make their title be the accent color of the card
- Make the background color of the cards be slightly more transparent
- Migrate what's possible to the `src` folder
- Make all components styles file begin with an underscore
- Add variables for general styles
- A huge styles cleanup
- Minor changes to the formatter and the linter
### Development Changes
- Add `ESLint` to the project for better code consistency
- Minor changes to the formatter and the linter
## 2.0.2 (2024-06-05)
### Fix(es)
- Make minimal ignore the `article` configuration
## 2.0.1 (2024-06-05)
### Fix(es)
- Fix the `main` on smaller screens
## 2.0.0 (2024-06-05)
### Breaking Changes
- Rename `blog` configuration to `article`
- Giscus comments configuration via `theme` -> `articles` -> `giscus` instead of `theme` -> `data`
- Make `minimal` layout an option in the configuration, rather then an import
- Make the Blog List an custom component due to it's complexity
- This will allow for more customization and easier maintenance
- **Will require extra effort to implement it again** (example provided in the [documentation](https://aplos.gxbs.me/guide/articles-list) and package file under `custom/BlogListExample.txt`)
- Remove all fallbacks for the old names
- `blog-*` -> `article-*`
- `no-blog` -> `minimal`
- `simple` -> `helpful` (for the layout)
### Features
- Rework the informational cards colors
- Provide a non-custom font version of Aplós (`aplos/plain`)
- Provide `style` frontmatter configuration for any page
- `numeric` for numeric style headings
- Make Icon Links a toggleable option in Configuration
- Add `note` informal card
- Small changes to images behavior
- Smaller scale when active
- Max width for images when active
- Images with a link:
- Add pointer cursor
- Make border thicker when hover
- Better accessibility for keyboard users
- With an custom focus indicator
- Add support for various types of elements
- `progress` for progress bars
- `samp` for sample output
- `legend` for legends
- `q` for inline quotes
- `u` for trying to replicate grammer mistakes
- `del` for deleted text
- `ins` for inserted text
### Cleanup(s)
- Added an warning that the ActivityPub-based comments aren't currently working
- Add a `custom` folder for custom components
- Remove Layout imports from Aplós Minimal (useless imports)
- Sort imports in Aplós Minimal
- Make Geist Mono/Main Monospace an variable
### Fix(es)
- Make just the `glitch` class be animated in the Not Found page (instead of all `<span>` elements)
### For Development
- Add `Prettier` to the project for better code consistency (replaceing `EditorConfig`)
- Add an [Contributing](https://aplos.gxbs.me/contributing) page for clear steps on how to contribute
- Make everything more <abbr title="Don't Repeat Yourself">DRY</abbr> by using `mixin` in repeated styles
## 1.6.0 (2024-05-25)
### Feature(s)
- Add a `no-underline` class to remove the underline from links
- Make the Content's Width adjustable
- Make "Create a new Issue" button in the Helpful Layout optional
- Provide Modern Font Stacks for the system font stack
- Make "File an Issue" button on the not found page optional
- Make the Not Found page smaller in width by 30%
### Cleanup(s)
- Migrate the Helpful Layout and the Not Found Layout to the `layouts` folder
- Migrate styles from `index.scss` and `common.scss` to their respective files if they are big enough for better organization
- General cleanup of content and code
- Rebrand the `blog-*` classes to `article-*` classes (the components themselves were already rebranded in 1.5.0)
- Cleanup the Not Found's View Styles
- Add Aplós' version to `index.scss` for better tracking
- Sort Imports
- Sort Styles in Components
### For Development
- Update Dependencies inside the Development Example
- Add `.editorconfig` file for better code consistency
## 1.5.1 (2024-05-18)
### Feature(s)
- Unify `color-accent-alpha` dark and light into one variable
## 1.5.0 (2024-05-11)
### Feature(s)
- Ability to style images via the URL (with `#` + `not-rounded`, `static`, `small`, `medium`, `shadow`, `mono`, `invert` `blur`, `sepia`, `transparency`)
- Give a title for Table of Contents for better accessibility
- Disable the languge detection for code snippets when hovering over them
- Provide the version of Aplós in the footer when hovering over ”Aplós” in ”Powered by”
- Add a "Skip to Content" link for better accessibility, and showing when `Tab` is pressed
- Replace `blog-*` with `article-*` for better naming(_Temporary Fallback is provided_)
- Replace `no-blog` with `minimal` for better naming and understanding (_Temporary Fallback is provided, **but not for the layout**_)
> Fallbacks are provided for the old names, but it is recommended to update the names to the new ones. In 2.0.0, the old names will be removed. The fallbacks are only here to not pump the version to 2.0.0 just for this change.
### Fix(es)
- Remove the margin from `code` tags inside `pre` tags on mobile
### Cleanup(s)
- Add border to link images (with the option to remove it)
- Migrate the body to an grid layout
- Move Layouts to their own folder
- Add underline to the links in the Table of Contents
- Add margin to the links in the Table of Contents
- Update the project details in `index.scss` to match the License
### For Development
- Add .development/default folder to the repository for easy development and testing (after the issue of the last release)
- Add `.npmignore` file to ignore the `.development` and `.github` folders
### Dependencies
- Pump SASS from 1.76.0 to 1.77.0 (https://github.com/aplosdev/aplos/pull/2)
### Work in Progress Element(s)
- Reinstate the ActivityPub comments _(not yet fully implemented)_
- [x] Migrate script to TypeScript locally
- [x] Make it run `onMounted`
- [ ] Fix the build issue
- Allow elements to go over the allocated width
- [x] Migrate body to an grid
- [ ] Provide Grid Templates
## 1.4.1 (2024-05-05)
> This release is important to fix the build process of the project, so update as soon as possible.
### Fix(es)
- Disable ActivityPub comments (for now, till I find a fix for the errors on the build process)
### Work in Progress Element(s)
- A full rework of how ActivityPub comments are handled (to avoid errors on build)
- Allowing elements to go over
## 1.4.0 (2024-05-04)
### Cleanup(s)
- Remove duplicated styles that are now provided by `normalize.css`
- Provide an easier way to make the time blink in the `time` tag (now using bold instead of `span`)
- Migrate basic font configuration to the `fonts.scss` file (rather than the `index.scss` file)
- Migrate all `pixel` values to `rem` values for better accessibility
### Fix(es)
- Allow a changeable dark mode background color for code snippets
- Made the navigation island have a specific minimum height (it could become smaller until now)
### Feature(s)
- Add ActivityPub support for comments (now you can choose between `activitypub` and `giscus`)
- Provide a `title` for the navigation icons to improve accessibility
- Add two new types of links (`external` and `internal`) with different icons at the end of the link
- Provide a build-in icon for custom cards
## 1.3.3 (2024-04-27)
### Feature(s)
- **normalize.css:** Add normalize.css to the project for better cross-browser compatibility
### Cleanup(s)
- Migrated specific styles from the main SCSS file to it's component's file
## 1.3.2 (2024-04-24)
### Features
- **spoiler:** Provide a way to show spoilers while blurring the text