courseroad, CourseRoad是大学生的四年学术计划

分享于 

7分钟阅读

GitHub

  繁體 雙語
CourseRoad is a four-year academic planner for undergraduates.
  • 源代码名称:courseroad
  • 源代码网址:http://www.github.com/dannybd/courseroad
  • courseroad源代码文档
  • courseroad源代码下载
  • Git URL:
    git://www.github.com/dannybd/courseroad.git
    Git Clone代码到本地:
    git clone http://www.github.com/dannybd/courseroad
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/dannybd/courseroad
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    CourseRoad

    CourseRoad是麻省理工学院大学生四年学术计划。 它作为一个单页应用程序,它的特点是用户可以添加他们的课程和专业人员。 使用匿名哈希可以保存用户的'课程配置("道路,但登录允许用户管理保存的道路。更改给定道路的哈希或者将道路标记为路( 在 courseroad.mit.edu/username 上可见的地方)。

    这将使CourseRoad成为计划未来的类,专业和成年的简单方法,然后与你想要的人共享这些计划。 检查双专业是否是可行的( 把想法电邮给你的顾问) 现在是否很容易。

    你可以在这里看到CourseRoad的一个工作示例: https://courseroad.mit.edu/dannybd

    安装

    尽管许多工作已经进入了代码可以移植性,但它仍依赖于sa的功能( 比如 )。 MIT证书用于登录,课程从数据仓库中提取,区域性( 比如 )。 应用程序需要学生专业和课程,课程由主题) ( 8.033 ) 引用,而不是标题( 相关性)。 进一步的工作需要把这段代码推广到其他高校。

    除了这些警告,MIT实现需要对数据仓库。对数据仓库的访问以及你自己的SQL数据库。

    设置好这些设置后,克隆 repo:

    
    git clone git://github.com/dannybd/courseroad.git && cd courseroad
    
    
    
    

    设置数据库表:

    
    mysql -u username -p -h localhost database_name <setup-courseroad-db.sql
    
    
    
    

    然后复制和修改模板文件以提供你的变量。 首先,设置CR_HOST和CR_PATH的值,这些值必须对 public URL进行 MATCH:

    
    cp. htaccess-TEMPLATE. htaccess && nano. htaccess
    
    
    
    

    其次,设置数据库凭据的值:

    
    cp settings.ini-TEMPLATE settings.ini && nano settings.ini
    
    
    
    

    这里时,你可以加载CourseRoad实例,而且它应该是 functioning--albeit,而不是任何课程信息。 要修复这里问题,编辑 pull-new-classes.sh 以提供带有数据仓库凭据和applyFilter实现的脚本,然后导入一个好的类,以开始使用:

    
    bash pull-new-classes.sh -n 365
    
    
    # Script usage:
    
    
    # -n N Pulls all classes updated in the Warehouse in the last N days. Defaults to 1.
    
    
    # -t Runs the script in test mode, and doesn't actually save the classes into your database.
    
    
    
    

    建议在每天基础上建立一个on作为最新的类。

    API参考

    在某种程度上,有一个允许你将类导入到CourseRoad中的API。 如果你像这样构造一个 URL:

    
    https://courseroad.mit.edu/?hash=ZmQ3M0&year=2015&term=3&addclasses=8.02,18.03,7.014,STS.050
    
    
    
    

    ###Important 位:

    • addClasses [required]: 逗号分隔的类列表。 联合类( Js附加了) 可以在末尾拥有或者不具有J: 由 你 作主.

    • 散列: 散列对应于用户要附加类的路径。 这是可选的:将它的省略将把类添加到空道路。

    • 年:pull的学术年版本。 默认值是明年的任何内容。 如果你请求一年( 比如。 2016 ) 当没有类数据时,CourseRoad将在它的可以用时使用 2016数据来进行 switch。 注意,秋季 2015在'15 -'16学年,因此计数为 2016.

    • 学期的学期数。 它遵循 Pattern,如下所示:

      
       0 = Prior Credit
      
      
       1 = Freshman Fall
      
      
       2 = Freshman IAP
      
      
       3 = Freshman Spring
      
      
       4 = Freshman Summer
      
      
       5 = Sophomore Fall
      
      
      . . .
      
      
       9 = Junior Fall
      
      
      . . .
      
      
       13 = Senior Fall
      
      
      . . .
      
      
       17 = Super-Senior Fall
      
      
      
      

    默认为 1,新生秋季。

    维护技巧

    对于专业或者班级的更正,请尝试分别确认它们是正确的。 如果你不能通过,/,目录查找,回复并询问更改的源,可以保留你的记录。 ( 当课程管理员与你联系时,不要这样做,因为他们是真实的事实部门。)

    对专业/未成年人的更改需要代码编辑。 所有这些都存储在 /majors ;comment顶部的注释块解释了这些Fragment的组合,并在 js/cr中解释了你可以给必要的需求的额外调整。

    对类( 通常不正确的必要解析)的更改需要数据库访问。 数据库数据库中包含一个表,它存储从数据仓库中提取的数据的数据行,其中注册者存储规范课程信息日期和 2002. 我还有另一个表 warehouse_exceptions,它与 warehouse 有相同的。 当某个类出现问题时,我将它的行从 warehouse 复制到 warehouse_exceptions,并在后者中进行编辑,使仓库未被修改。 ( 当获取类数据时,从 warehouse_exceptions 中提取的行是第一次被拉

    当代码中的Bug 出现时,我通常会把它们变成。 不过,人们将拥有的最常见的non-majors-or-classes问题是登录。 问题通常是: 当提示他们的证书( 因此,防止CourseRoad再次询问),或者他们的证书已经过期时,他们点击了取消。 如果这封邮件在August之后到达,我告诉他们去然后再试一次。 否则,我告诉人们在隐身窗口或者不同的浏览器中尝试,因为CourseRoad可以再次询问证书。

    贡献者

    问题。评论。Bug 和投诉都可以直接指向这个的NAME

    许可证

    在MIT许可证的所有内容。