soargroup / soargroup.github.io Goto Github PK
View Code? Open in Web Editor NEWSoar's website: documentation, news, announcements, links, etc.
Home Page: http://soar.eecs.umich.edu/
License: Other
Soar's website: documentation, news, announcements, links, etc.
Home Page: http://soar.eecs.umich.edu/
License: Other
A lot of projects provide some information on how to cite the project if used in a publication.
I assume the appropriate source would be The Soar Cognitive Architecture which is on the landing page anyway?
Just noticed the landing page states 2012, but the latest version apparently is from 2019, at least according to the MIT Press website.
Old versions of Soar and its utilities are up on SourceForge:
https://sourceforge.net/projects/soar/files/
Related: #11
I think it would be easier to navigate if you make the tab menu bar "sticky" so that it will not go away when you scroll down. Otherwise, you have to scroll back to the top to get back to the menu bar, which can involve a lot of scrolling in some cases.
Just add navigation.tabs.sticky
to the features
section:
features:
...
- navigation.tabs
- navigations.tabs.sticky
...
The links on the Publications page to /pubs/ need to be updated to point to the instead.
It would be nice, if the Soar code snippets on the website would have syntax highlighting.
According to the MkDocs Material docs relies on pygments to highlight the syntax of code blocks. Unfortunately, pygments does not have a Soar lexer, yet.
I have created a pygments lexer for Soar in my fork, but this needs more work until it might be in a state which is acceptable to be merged in pygments.
Tasks for native highlighting for Soar code via mkdocs:
Presently, the Soar website has a page with instructions to build Soar with ROS1 based on Lizzie's code (https://soar.eecs.umich.edu/development/BuildingSoarRos/), but no page describing how to build Soar by itself. This would be nice for those of us modifying Soar directly for research, etc.
The SML Quick Start Guide
refers to the "Soar XML Interface Specification", but I could not find that anywhere.
Could you add that to the documentation or at least provide a pointer to where it actually lives?
All of the link URLs are set to TODO
on the archives download page: https://soar.eecs.umich.edu/downloads/soar/archive/.
I believe that all of the old Soar versions listed here should be in the website-downloads repo in the Archives folder. The links should be the raw file ones, so they should all start with https://raw.githubusercontent.com/SoarGroup/website-downloads/main/Archives/
.
The link is dead. Find the new URL or delete the reference. For now we are ignoring it in the link-checking CI.
Generating the PDF of the Soar manual results in multiple missing character errors:
[WARNING] Missing character: There is no (U+0088) (U+0088) in font [lmroman12-regular]:+tlig;!
I'm not sure if more figures are missing, but when reading https://soar.eecs.umich.edu/soar_manual/06_SemanticMemory/, I noticed that figure 6.1 was not visible at all on the website while it is visible in the PDF
Just noticed that the WIP warning for the Soar manual and the Soar tutorials somehow disables the
table of contents column on the right-hand side.
Remaining work listed in #12:
One using LEGO MINDSTORMS is here: https://docs.google.com/document/d/1o9cWNXP0AgLJzQmlCPAdEuyOAd7NEor-ECX9C724lwE/edit. MINDSTORMS have been discontinued, unfortunately, but I think the tutorial is still valuable.
2019 workshop tutorials: https://web.archive.org/web/20230616111252/https://soar.eecs.umich.edu/tutorial/
From #3:
The following chapters should be very close to the original version:
Chapter 1: Introduction
Chapter 2: The Soar Architecture
Chapter 3: Soar Syntax
Chapter 9: Soar User Interface
For chapter 9 I decided to link to the CLI documentation that is included in the PDF anyways. A pandoc filter, cf. path_filter.lua, is used to keep the links inside the conversion from multiple Markdown files to a single PDF document valid. Unfortunately, this requires that links to other parts of the Soar manual must include a section reference.
Unfortunately, I did not have time to go through the other chapters and compare them very closely to the manual about formatting and completeness.
We have:
I like keeping this repository light, so I'm inclined to keep them out of here. I'm thinking another repository dedicated to binary assets would be ideal.
We have dozens of agents, tools, etc. that were downloadable from the old website. The last couple of Soar releases have included all of them in the zip, which I don't think is idea. All of the explanations, author names, etc. are gone.
Particularly an SML programming reference would be very helpful, since SWIG ignores Doxygen comments, and Python/Java, etc. developers are mostly flying blind. Whenever I need to understand something about the SML API, I search through Soar's C++ code for the original definition and read the comments there.
SVG can have CSS in it, so it is possible to change the colors based on whether the user has dark mode activated or not.
For now, users can just switch to light mode to view the images.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.